pbx.c File Reference

Core PBX routines. More...

#include "asterisk.h"
#include "asterisk/_private.h"
#include "asterisk/paths.h"
#include <ctype.h>
#include <time.h>
#include <sys/time.h>
#include <sys/sysinfo.h>
#include "asterisk/lock.h"
#include "asterisk/cli.h"
#include "asterisk/pbx.h"
#include "asterisk/channel.h"
#include "asterisk/file.h"
#include "asterisk/callerid.h"
#include "asterisk/cdr.h"
#include "asterisk/cel.h"
#include "asterisk/config.h"
#include "asterisk/term.h"
#include "asterisk/manager.h"
#include "asterisk/ast_expr.h"
#include "asterisk/linkedlists.h"
#include "asterisk/say.h"
#include "asterisk/utils.h"
#include "asterisk/causes.h"
#include "asterisk/musiconhold.h"
#include "asterisk/app.h"
#include "asterisk/devicestate.h"
#include "asterisk/presencestate.h"
#include "asterisk/event.h"
#include "asterisk/hashtab.h"
#include "asterisk/module.h"
#include "asterisk/indications.h"
#include "asterisk/taskprocessor.h"
#include "asterisk/xmldoc.h"
#include "asterisk/astobj2.h"

Include dependency graph for pbx.c:

Go to the source code of this file.

Data Structures
struct	acf_root
struct	app_tmp
struct	apps
struct	ast_app
	ast_app: A registered application More...
struct	ast_context
	ast_context: An extension context More...
struct	ast_custom_escalating_function
	Extra information for an ast_custom_function holding privilege escalation information. Kept in a separate structure for ABI compatibility. More...
struct	ast_exten
	ast_exten: An extension The dialplan is saved as a linked list with each context having it's own linked list of extensions - one item per priority. More...
struct	ast_hint
	Structure for dial plan hints. More...
struct	ast_hintdevice
	Structure for dial plan hint devices. More...
struct	ast_ignorepat
	ast_ignorepat: Ignore patterns in dial plan More...
struct	ast_include
	ast_include: include= support in extensions.conf More...
struct	ast_state_cb
	ast_state_cb: An extension state notify register item More...
struct	ast_sw
	ast_sw: Switch statement in extensions.conf More...
struct	async_stat
struct	cfextension_states
struct	dialplan_counters
	Counters for the show dialplan manager command. More...
struct	escalation_root
struct	fake_context
struct	match_char
	match_char: forms a syntax tree for quick matching of extension patterns More...
struct	pattern_node
struct	pbx_builtin
	Declaration of builtin applications. More...
struct	pbx_exception
struct	presencechange
struct	scoreboard
struct	statechange
struct	store_hint
struct	store_hints
struct	switches
Defines
#define	BACKGROUND_MATCHEXTEN   (1 << 2)
#define	BACKGROUND_NOANSWER   (1 << 1)
#define	BACKGROUND_PLAYBACK   (1 << 3)
#define	BACKGROUND_SKIP   (1 << 0)
#define	BITS_PER   8 /* Number of bits per unit (byte). */
#define	EXT_DATA_SIZE   8192
#define	HANDLER_FORMAT   "%-30s %s\n"
#define	HASH_EXTENHINT_SIZE   563
#define	HINTDEVICE_DATA_LENGTH   16
#define	INC_DST_OVERFLOW_CHECK
#define	NEW_MATCHER_CHK_MATCH
#define	NEW_MATCHER_RECURSE
#define	SAY_STUBS   /* generate declarations and stubs for say methods */
#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	SWITCH_DATA_LENGTH   256
#define	VAR_BUF_SIZE   4096
#define	VAR_HARDTRAN   3
#define	VAR_NORMAL   1
#define	VAR_SOFTTRAN   2
#define	WAITEXTEN_DIALTONE   (1 << 1)
#define	WAITEXTEN_MOH   (1 << 0)
Functions
void	__ast_context_destroy (struct ast_context *list, struct ast_hashtab *contexttab, struct ast_context *con, const char *registrar)
int	__ast_custom_function_register (struct ast_custom_function *acf, struct ast_module *mod)
	Register a custom function.
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.
static int	__ast_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority, int async)
static void	__ast_internal_context_destroy (struct ast_context *con)
static enum ast_pbx_result	__ast_pbx_run (struct ast_channel *c, struct ast_pbx_args *args)
static void	__init_extensionstate_buf (void)
static void	__init_hintdevice_data (void)
static void	__init_switch_data (void)
static void	__init_thread_inhibit_escalations_tl (void)
	A thread local indicating whether the current thread can run 'dangerous' dialplan functions.
static int	_extension_match_core (const char *pattern, const char *data, enum ext_match_t mode)
static int	acf_exception_read (struct ast_channel *chan, const char *name, char *data, char *buf, size_t buflen)
static int	acf_retrieve_docs (struct ast_custom_function *acf)
static struct match_char *	add_exten_to_pattern_tree (struct ast_context *con, struct ast_exten *e1, int findonly)
static int	add_hintdevice (struct ast_hint *hint, const char *devicelist)
	add hintdevice structure and link it into the container.
static struct match_char *	add_pattern_node (struct ast_context *con, struct match_char *current, const struct pattern_node *pattern, int is_pattern, int already, struct match_char **nextcharptr)
static int	add_priority (struct ast_context *con, struct ast_exten *tmp, struct ast_exten *el, struct ast_exten *e, int replace)
	add the extension in the priority chain.
static struct ao2_container *	alloc_device_state_info (void)
static struct match_char *	already_in_tree (struct match_char *current, char *pat, int is_pattern)
int	ast_active_calls (void)
	Retrieve the number of active calls.
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.
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)
	Main interface to add extensions to the list for out context.
static int	ast_add_extension2_lockopt (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, int lock_context)
	Same as ast_add_extension2() but controls the context locking.
static int	ast_add_extension_nolock (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)
static int	ast_add_hint (struct ast_exten *e)
	Add hint to hint list, check initial extension state.
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.
int	ast_async_goto_by_name (const char *channame, const char *context, const char *exten, int priority)
	Set the channel to next execute the specified dialplan location.
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.
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.
static int	ast_change_hint (struct ast_exten *oe, struct ast_exten *ne)
	Change hint for an extension.
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.
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.
char *	ast_complete_applications (const char *line, const char *word, int state)
	Command completion for the list of installed applications.
int	ast_context_add_ignorepat (const char *context, const char *value, const char *registrar)
	Add an ignorepat.
int	ast_context_add_ignorepat2 (struct ast_context *con, const char *value, const char *registrar)
int	ast_context_add_include (const char *context, const char *include, const char *registrar)
	Add a context include.
int	ast_context_add_include2 (struct ast_context *con, const char *value, const char *registrar)
	Add a context include.
int	ast_context_add_switch (const char *context, const char *sw, const char *data, int eval, const char *registrar)
	Add a switch.
int	ast_context_add_switch2 (struct ast_context *con, const char *value, const char *data, int eval, const char *registrar)
	Adds a switch (first param is a ast_context)
void	ast_context_destroy (struct ast_context *con, const char *registrar)
	Destroy a context (matches the specified context (or ANY context if NULL)
struct ast_context *	ast_context_find (const char *name)
	Find a context.
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.
int	ast_context_lockmacro (const char *context)
	locks the macrolock in the given given context
int	ast_context_remove_extension (const char *context, const char *extension, int priority, const char *registrar)
	Simply remove extension from context.
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.
int	ast_context_remove_extension_callerid (const char *context, const char *extension, int priority, const char *callerid, int matchcallerid, const char *registrar)
int	ast_context_remove_extension_callerid2 (struct ast_context *con, const char *extension, int priority, const char *callerid, int matchcallerid, const char *registrar, int already_locked)
int	ast_context_remove_ignorepat (const char *context, const char *ignorepat, const char *registrar)
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 included contexts. This function locks contexts list by &conlist, search for the right context structure, leave context list locked and call ast_context_remove_include2 which removes include, unlock contexts list and return ...
int	ast_context_remove_include2 (struct ast_context *con, const char *include, const char *registrar)
	Locks context, remove included contexts, unlocks context. 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.
int	ast_context_remove_switch (const char *context, const char *sw, const char *data, const char *registrar)
	Remove a switch.
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.
int	ast_context_unlockmacro (const char *context)
	Unlocks the macrolock in the given context.
int	ast_context_verify_includes (struct ast_context *con)
	Verifies includes in an ast_contect structure.
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.
int	ast_destroy_timing (struct ast_timing *i)
	Deallocates memory structures associated with a timing bitmap.
enum ast_extension_states	ast_devstate_to_extenstate (enum ast_device_state devstate)
	Map devstate to an extension state.
int	ast_exists_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Determine whether an extension exists.
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.
int	ast_extension_match (const char *pattern, const char *data)
	Determine if a given extension matches a given pattern (in NXX format)
int	ast_extension_state (struct ast_channel *c, const char *context, const char *exten)
	Check extension state for an extension by using hint.
static int	ast_extension_state2 (struct ast_exten *e, struct ao2_container *device_state_info)
	Check state of extension by using hints.
const char *	ast_extension_state2str (int extension_state)
	Return extension_state as string.
static int	ast_extension_state3 (struct ast_str *hint_app, struct ao2_container *device_state_info)
int	ast_extension_state_add (const char *context, const char *exten, ast_state_cb_type change_cb, void *data)
	Add watcher for extension states.
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.
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.
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.
int	ast_extension_state_del (int id, ast_state_cb_type change_cb)
	ast_extension_state_del: Remove a watcher from the callback list
int	ast_extension_state_extended (struct ast_channel *c, const char *context, const char *exten, struct ao2_container **device_state_info)
	Check extended extension state for an extension by using hint.
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.
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.
int	ast_func_read (struct ast_channel *chan, const char *function, char *workspace, size_t len)
	executes a read operation on a function
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
int	ast_func_write (struct ast_channel *chan, const char *function, const char *value)
	executes a write operation on a function
const char *	ast_get_context_name (struct ast_context *con)
const char *	ast_get_context_registrar (struct ast_context *c)
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)
struct ast_context *	ast_get_extension_context (struct ast_exten *exten)
const char *	ast_get_extension_label (struct ast_exten *exten)
int	ast_get_extension_matchcid (struct ast_exten *e)
const char *	ast_get_extension_name (struct ast_exten *exten)
int	ast_get_extension_priority (struct ast_exten *exten)
const char *	ast_get_extension_registrar (struct ast_exten *e)
int	ast_get_hint (char *hint, int hintsize, char *name, int namesize, struct ast_channel *c, const char *context, const char *exten)
	Get hint for channel.
const char *	ast_get_ignorepat_name (struct ast_ignorepat *ip)
const char *	ast_get_ignorepat_registrar (struct ast_ignorepat *ip)
const char *	ast_get_include_name (struct ast_include *inc)
const char *	ast_get_include_registrar (struct ast_include *i)
const char *	ast_get_switch_data (struct ast_sw *sw)
int	ast_get_switch_eval (struct ast_sw *sw)
const char *	ast_get_switch_name (struct ast_sw *sw)
const char *	ast_get_switch_registrar (struct ast_sw *sw)
int	ast_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_hashtab_compare_contexts (const void *ah_a, const void *ah_b)
	hashtable functions for contexts
unsigned int	ast_hashtab_hash_contexts (const void *obj)
static struct ast_exten *	ast_hint_extension (struct ast_channel *c, const char *context, const char *exten)
static struct ast_exten *	ast_hint_extension_nolock (struct ast_channel *c, const char *context, const char *exten)
	Find hint for given extension in context.
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.
int	ast_ignore_pattern (const char *context, const char *pattern)
	Checks to see if a number should be ignored.
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)
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.
int	ast_parseable_goto (struct ast_channel *chan, const char *goto_string)
void	ast_pbx_h_exten_run (struct ast_channel *chan, const char *context)
	Run the h exten from the given context.
void	ast_pbx_hangup_handler_destroy (struct ast_channel *chan)
	Destroy the hangup handler container on a channel.
static void	ast_pbx_hangup_handler_headers (int fd)
void	ast_pbx_hangup_handler_init (struct ast_channel *chan)
	Init the hangup handler container on a channel.
int	ast_pbx_hangup_handler_pop (struct ast_channel *chan)
	Pop the top of the channel hangup handler stack.
void	ast_pbx_hangup_handler_push (struct ast_channel *chan, const char *handler)
	Push the given hangup handler onto the channel hangup handler stack.
int	ast_pbx_hangup_handler_run (struct ast_channel *chan)
	Run all hangup handlers on the channel.
static void	ast_pbx_hangup_handler_show (int fd, struct ast_channel *chan)
int	ast_pbx_init (void)
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)
static int	ast_pbx_outgoing_cdr_failed (void)
	Function to post an empty cdr after a spool call fails.
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 **channel, int early_media)
enum ast_pbx_result	ast_pbx_run (struct ast_channel *c)
	Execute the PBX in the current thread.
static void *	ast_pbx_run_app (void *data)
	run the application and free the descriptor once done
enum ast_pbx_result	ast_pbx_run_args (struct ast_channel *c, struct ast_pbx_args *args)
	Execute the PBX in the current thread.
enum ast_pbx_result	ast_pbx_start (struct ast_channel *c)
	Create a new thread and start the PBX.
int	ast_processed_calls (void)
	Retrieve the total number of calls processed through the PBX since last restart.
int	ast_rdlock_context (struct ast_context *con)
	Read locks a given context.
int	ast_rdlock_contexts (void)
	Read locks the context list.
int	ast_register_application2 (const char *app, int(*execute)(struct ast_channel *, const char *), const char *synopsis, const char *description, void *mod)
	Dynamically register a new dial plan application.
int	ast_register_switch (struct ast_switch *sw)
	Register an alternative dialplan switch.
static int	ast_remove_hint (struct ast_exten *e)
	Remove hint from 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)
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)
	Get hint for channel.
const char *	ast_str_retrieve_variable (struct ast_str **str, ssize_t maxlen, struct ast_channel *c, 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_varshead (struct ast_str **buf, ssize_t maxlen, struct varshead *headp, const char *templ)
static const char *	ast_str_substring (struct ast_str *value, int offset, int length)
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.
int	ast_unlock_context (struct ast_context *con)
int	ast_unlock_contexts (void)
	Unlocks contexts.
int	ast_unregister_application (const char *app)
	Unregister an application.
void	ast_unregister_switch (struct ast_switch *sw)
	Unregister an alternative switch.
struct ast_exten *	ast_walk_context_extensions (struct ast_context *con, struct ast_exten *exten)
struct ast_ignorepat *	ast_walk_context_ignorepats (struct ast_context *con, struct ast_ignorepat *ip)
struct ast_include *	ast_walk_context_includes (struct ast_context *con, struct ast_include *inc)
struct ast_sw *	ast_walk_context_switches (struct ast_context *con, 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)
int	ast_wrlock_context (struct ast_context *con)
	Write locks a given context.
int	ast_wrlock_contexts (void)
	Write locks the context list.
static void *	async_wait (void *data)
static void	cli_match_char_tree (struct match_char *node, char *prefix, int fd)
static int	collect_digits (struct ast_channel *c, int waittime, char *buf, int buflen, int pos)
	collect digits from the channel into the buffer.
static int	compare_char (const void *a, const void *b)
static char *	complete_core_show_hint (const char *line, const char *word, int pos, int state)
	autocomplete for CLI command 'core show hint'
static char *	complete_show_dialplan_context (const char *line, const char *word, int pos, int state)
static void	context_merge (struct ast_context **extcontexts, struct ast_hashtab *exttable, struct ast_context *context, const char *registrar)
static void	context_merge_incls_swits_igps_other_registrars (struct ast_context *new, struct ast_context *old, const char *registrar)
static void	create_match_char_tree (struct ast_context *con)
static void	decrease_call_count (void)
static void	destroy_exten (struct ast_exten *e)
static void	destroy_hint (void *obj)
static void	destroy_pattern_tree (struct match_char *pattern_tree)
static void	destroy_state_cb (void *doomed)
static void	device_state_cb (const struct ast_event *event, void *unused)
static void	device_state_info_dt (void *obj)
static void	exception_store_free (void *data)
static int	execute_state_callback (ast_state_cb_type cb, const char *context, const char *exten, void *data, enum ast_state_cb_update_reason reason, struct ast_hint *hint, struct ao2_container *device_state_info)
static int	ext_cmp (const char *left, const char *right)
static int	ext_cmp_exten (const char *left, const char *right)
static int	ext_cmp_exten_partial (const char *left, const char *right)
static int	ext_cmp_exten_strlen (const char *str)
static int	ext_cmp_pattern (const char *left, const char *right)
static int	ext_cmp_pattern_pos (const char **p, unsigned char *bitwise)
	helper functions to sort extension patterns in the desired way, so that more specific patterns appear first.
static int	ext_strncpy (char *dst, const char *src, int len)
	copy a string skipping whitespace
static int	extension_match_core (const char *pattern, const char *data, enum ext_match_t mode)
static int	extension_presence_state_helper (struct ast_exten *e, char **subtype, char **message)
static int	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, int extended)
static struct ast_context *	find_context (const char *context)
	lookup for a context with a given name,
static struct ast_context *	find_context_locked (const char *context)
	lookup for a context with a given name,
static int	find_hint_by_cb_id (void *obj, void *arg, int flags)
	Find Hint by callback id.
static char *	func_args (char *function)
	return a pointer to the arguments of the function, and terminates the function name with '\0'
static struct ast_exten *	get_canmatch_exten (struct match_char *node)
static void	get_device_state_causing_channels (struct ao2_container *c)
static const char *	get_pattern_node (struct pattern_node *node, const char *src, int pattern, const char *extenbuf)
static unsigned	get_range (char *src, int max, const char *const names[], const char *msg)
	helper function to return a range up to max (7, 12, 31 respectively). names, if supplied, is an array of names that should be mapped to numbers.
static void	get_timerange (struct ast_timing *i, char *times)
	store a bitmask of valid times, one bit each 1 minute
static char *	handle_debug_dialplan (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	Send ack once.
static int	handle_presencechange (void *datap)
static char *	handle_set_chanvar (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_set_extenpatternmatchnew (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_set_global (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_application (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_applications (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_chanvar (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	CLI support for listing chanvar's variables in a parseable way.
static char *	handle_show_dialplan (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_function (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_functions (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_globals (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	CLI support for listing global variables in a parseable way.
static char *	handle_show_hangup_all (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_hangup_channel (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_hint (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	handle_show_hint: CLI support for listing registered dial plan hint
static char *	handle_show_hints (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	handle_show_hints: CLI support for listing registered dial plan hints
static char *	handle_show_switches (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	handle_show_switches: CLI support for listing registered dial plan switches
static int	handle_statechange (void *datap)
static char *	handle_unset_extenpatternmatchnew (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static int	hashtab_compare_exten_labels (const void *ah_a, const void *ah_b)
static int	hashtab_compare_exten_numbers (const void *ah_a, const void *ah_b)
static int	hashtab_compare_extens (const void *ha_a, const void *ah_b)
static unsigned int	hashtab_hash_extens (const void *obj)
static unsigned int	hashtab_hash_labels (const void *obj)
static unsigned int	hashtab_hash_priority (const void *obj)
static int	hint_cmp (void *obj, void *arg, int flags)
static int	hint_hash (const void *obj, const int flags)
static int	hint_id_cmp (void *obj, void *arg, int flags)
static int	hintdevice_cmp_multiple (void *obj, void *arg, int flags)
static void	hintdevice_destroy (void *obj)
static int	hintdevice_hash_cb (const void *obj, const int flags)
static int	hintdevice_remove_cb (void *deviceobj, void *arg, int flags)
static int	hints_data_provider_get (const struct ast_data_search *search, struct ast_data *data_root)
static int	include_valid (struct ast_include *i)
static int	increase_call_count (const struct ast_channel *c)
	Increase call count for channel.
static void	insert_in_next_chars_alt_char_list (struct match_char **parent_ptr, struct match_char *node)
static int	internal_extension_state_extended (struct ast_channel *c, const char *context, const char *exten, struct ao2_container *device_state_info)
static int	is_read_allowed (struct ast_custom_function *acfptr)
	Determines whether execution of a custom function's read function is allowed.
static int	is_write_allowed (struct ast_custom_function *acfptr)
	Determines whether execution of a custom function's write function is allowed.
int	load_pbx (void)
static int	lookup_name (const char *s, const char *const names[], int max)
	Helper for get_range. return the index of the matching entry, starting from 1. If names is not supplied, try numeric values.
static void	manager_dpsendack (struct mansession *s, const struct message *m)
	Send ack once.
static int	manager_show_dialplan (struct mansession *s, const struct message *m)
	Manager listing of dial plan.
static int	manager_show_dialplan_helper (struct mansession *s, const struct message *m, const char *actionidtext, const char *context, const char *exten, struct dialplan_counters *dpc, struct ast_include *rinclude)
	Show dialplan extensions XXX this function is similar but not exactly the same as the CLI's show dialplan. Must check whether the difference is intentional or not.
static int	matchcid (const char *cidpattern, const char *callerid)
static void	new_find_extension (const char *str, struct scoreboard *score, struct match_char *tree, int length, int spec, const char *callerid, const char *label, enum ext_match_t action)
static char *	parse_hint_device (struct ast_str *hint_args)
static char *	parse_hint_presence (struct ast_str *hint_args)
static int	parse_variable_name (char *var, int *offset, int *length, int *isfunc)
	extract offset:length from variable name.
static int	pbx_builtin_answer (struct ast_channel *, const char *)
static int	pbx_builtin_background (struct ast_channel *, const char *)
static int	pbx_builtin_busy (struct ast_channel *, const char *)
void	pbx_builtin_clear_globals (void)
static int	pbx_builtin_congestion (struct ast_channel *, const char *)
static int	pbx_builtin_execiftime (struct ast_channel *, const char *)
const char *	pbx_builtin_getvar_helper (struct ast_channel *chan, const char *name)
	Return a pointer to the value of the corresponding channel variable.
static int	pbx_builtin_goto (struct ast_channel *, const char *)
static int	pbx_builtin_gotoif (struct ast_channel *, const char *)
static int	pbx_builtin_gotoiftime (struct ast_channel *, const char *)
static int	pbx_builtin_hangup (struct ast_channel *, const char *)
static int	pbx_builtin_importvar (struct ast_channel *, const char *)
static int	pbx_builtin_incomplete (struct ast_channel *, const char *)
static int	pbx_builtin_noop (struct ast_channel *, const char *)
static int	pbx_builtin_proceeding (struct ast_channel *, const char *)
static int	pbx_builtin_progress (struct ast_channel *, const char *)
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.
int	pbx_builtin_raise_exception (struct ast_channel *chan, const char *reason)
static int	pbx_builtin_resetcdr (struct ast_channel *, const char *)
static int	pbx_builtin_ringing (struct ast_channel *, const char *)
static int	pbx_builtin_saycharacters (struct ast_channel *, const char *)
static int	pbx_builtin_saydigits (struct ast_channel *, const char *)
static int	pbx_builtin_saynumber (struct ast_channel *, const char *)
static int	pbx_builtin_sayphonetic (struct ast_channel *, const char *)
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.
static int	pbx_builtin_setamaflags (struct ast_channel *, const char *)
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.
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.
int	pbx_builtin_setvar_multiple (struct ast_channel *chan, const char *vdata)
	Parse and set multiple channel variables, where the pairs are separated by the ',' character, and name and value are separated with an '=' character.
static int	pbx_builtin_wait (struct ast_channel *, const char *)
static int	pbx_builtin_waitexten (struct ast_channel *, const char *)
int	pbx_checkcondition (const char *condition)
	Evaluate a condition.
static void	pbx_destroy (struct ast_pbx *p)
int	pbx_exec (struct ast_channel *c, struct ast_app *app, const char *data)
	Execute an application.
static int	pbx_extension_helper (struct ast_channel *c, struct ast_context *con, const char *context, const char *exten, int priority, const char *label, const char *callerid, enum ext_match_t action, int *found, int combined_find_spawn)
	The return value depends on the action:
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)
	Find application handle in linked list.
static struct ast_switch *	pbx_findswitch (const char *sw)
void	pbx_live_dangerously (int new_live_dangerously)
	Enable/disable the execution of 'dangerous' functions from external protocols (AMI, etc.).
static int	pbx_parseable_goto (struct ast_channel *chan, const char *goto_string, int async)
void	pbx_retrieve_variable (struct ast_channel *c, const char *var, char **ret, char *workspace, int workspacelen, struct varshead *headp)
	Support for Asterisk built-in variables in the dialplan.
int	pbx_set_autofallthrough (int newval)
int	pbx_set_extenpatternmatchnew (int newval)
void	pbx_set_overrideswitch (const char *newval)
static void	pbx_shutdown (void)
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 count, size_t *used)
void	pbx_substitute_variables_varshead (struct varshead *headp, const char *cp1, char *cp2, int count)
static void *	pbx_thread (void *data)
static void	presence_state_cb (const struct ast_event *event, void *unused)
static void	presencechange_destroy (void *data)
static void	print_app_docs (struct ast_app *aa, int fd)
static void	print_ext (struct ast_exten *e, char *buf, int buflen)
	helper function to print an extension
static int	raise_exception (struct ast_channel *chan, const char *reason, int priority)
static int	read_escalates (const struct ast_custom_function *acf)
	Returns true if given custom function escalates privileges on read.
static int	remove_hintdevice (struct ast_hint *hint)
static void	set_ext_pri (struct ast_channel *c, const char *exten, int pri)
static int	show_debug_helper (int fd, const char *context, const char *exten, struct dialplan_counters *dpc, struct ast_include *rinclude, int includecount, const char *includes[])
static int	show_dialplan_helper (int fd, const char *context, const char *exten, struct dialplan_counters *dpc, struct ast_include *rinclude, int includecount, const char *includes[])
static int	statecbs_cmp (void *obj, void *arg, int flags)
static char *	substring (const char *value, int offset, int length, char *workspace, size_t workspace_len)
	takes a substring. It is ok to call with value == workspace.
static int	testtime_write (struct ast_channel *chan, const char *cmd, char *var, const char *value)
static int	thread_inhibits_escalations (void)
	Indicates whether the current thread inhibits the execution of dangerous functions.
static struct ast_exten *	trie_find_next_match (struct match_char *node)
static void	unload_pbx (void)
static void	unreference_cached_app (struct ast_app *app)
static void	update_scoreboard (struct scoreboard *board, int length, int spec, struct ast_exten *exten, char last, const char *callerid, int deleted, struct match_char *node)
static void	wait_for_hangup (struct ast_channel *chan, const void *data)
static int	write_escalates (const struct ast_custom_function *acf)
	Returns true if given custom function escalates privileges on write.
Variables
static struct acf_root	acf_root
static struct apps	apps
static int	autofallthrough = 1
static struct ast_app_option	background_opts [128] = { [ 's' ] = { .flag = (1 << 0) }, [ 'n' ] = { .flag = (1 << 1) }, [ 'm' ] = { .flag = (1 << 2) }, [ 'p' ] = { .flag = (1 << 3) },}
static struct pbx_builtin	builtins []
static ast_mutex_t	conlock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, 1 }
	Lock for the ast_context list.
static ast_mutex_t	context_merge_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, 1 }
	Lock to hold off restructuring of hints by ast_merge_contexts_and_delete.
static struct ast_context *	contexts
static struct ast_hashtab *	contexts_table = NULL
static int	countcalls
static const char *const	days []
static struct ast_event_sub *	device_state_sub
	Subscription for device state change events.
static struct escalation_root	escalation_root
static struct ast_custom_function	exception_function
static struct ast_datastore_info	exception_store_info
static int	extenpatternmatchnew = 0
static struct ast_taskprocessor *	extension_state_tps
static struct cfextension_states	extension_states []
static struct ast_threadstorage	extensionstate_buf = { .once = PTHREAD_ONCE_INIT , .key_init = __init_extensionstate_buf , .custom_init = NULL , }
static struct varshead	globals = AST_LIST_HEAD_NOLOCK_INIT_VALUE
static ast_rwlock_t	globalslock = { PTHREAD_RWLOCK_INITIALIZER , NULL, 1 }
static struct ast_threadstorage	hintdevice_data = { .once = PTHREAD_ONCE_INIT , .key_init = __init_hintdevice_data , .custom_init = NULL , }
static struct ao2_container *	hintdevices
	Container for hint devices.
static struct ao2_container *	hints
static struct ast_data_handler	hints_data_provider
static int	live_dangerously
	Set to true (non-zero) to globally allow all dangerous dialplan functions to run.
static ast_mutex_t	maxcalllock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, 1 }
static const char *const	months []
static char *	overrideswitch = NULL
static struct ast_cli_entry	pbx_cli []
static struct ast_data_entry	pbx_data_providers []
static struct ast_event_sub *	presence_state_sub
	Subscription for presence state change events.
static struct ast_app_option	resetcdr_opts [128] = { [ 'w' ] = { .flag = AST_CDR_FLAG_POSTED }, [ 'a' ] = { .flag = AST_CDR_FLAG_LOCKED }, [ 'v' ] = { .flag = AST_CDR_FLAG_KEEP_VARS }, [ 'e' ] = { .flag = AST_CDR_FLAG_POST_ENABLE },}
static struct ao2_container *	statecbs
static int	stateid = 1
static struct ast_threadstorage	switch_data = { .once = PTHREAD_ONCE_INIT , .key_init = __init_switch_data , .custom_init = NULL , }
static struct switches	switches
static struct ast_custom_function	testtime_function
static struct ast_threadstorage	thread_inhibit_escalations_tl = { .once = PTHREAD_ONCE_INIT , .key_init = __init_thread_inhibit_escalations_tl , .custom_init = NULL , }
static int	totalcalls
static struct ast_app_option	waitexten_opts [128] = { [ 'm' ] = { .flag = (1 << 0) , .arg_index = 0 + 1 }, [ 'd' ] = { .flag = (1 << 1) , .arg_index = 0 + 1 },}

---

Detailed Description

Core PBX routines.

Author:

Mark Spencer <markster@digium.com>

Definition in file pbx.c.

---

Define Documentation

#define BACKGROUND_MATCHEXTEN   (1 << 2)

Definition at line 800 of file pbx.c.

Referenced by pbx_builtin_background().

#define BACKGROUND_NOANSWER   (1 << 1)

Definition at line 799 of file pbx.c.

Referenced by pbx_builtin_background().

#define BACKGROUND_PLAYBACK   (1 << 3)

Definition at line 801 of file pbx.c.

Referenced by pbx_builtin_background().

#define BACKGROUND_SKIP   (1 << 0)

Definition at line 798 of file pbx.c.

Referenced by pbx_builtin_background().

#define BITS_PER   8 /* Number of bits per unit (byte). */

Referenced by ext_cmp_pattern_pos().

#define EXT_DATA_SIZE   8192

Note:

I M P O R T A N T :

The speed of extension handling will likely be among the most important aspects of this PBX. The switching scheme as it exists right now isn't terribly bad (it's O(N+M), where N is the # of extensions and M is the avg # of priorities, but a constant search time here would be great ;-)

A new algorithm to do searching based on a 'compiled' pattern tree is introduced here, and shows a fairly flat (constant) search time, even for over 10000 patterns.

Also, using a hash table for context/priority name lookup can help prevent the find_extension routines from absorbing exponential cpu cycles as the number of contexts/priorities grow. I've previously tested find_extension with red-black trees, which have O(log2(n)) speed. Right now, I'm using hash tables, which do searches (ideally) in O(1) time. While these techniques do not yield much speed in small dialplans, they are worth the trouble in large dialplans.

Definition at line 787 of file pbx.c.

Referenced by pbx_extension_helper().

#define HANDLER_FORMAT   "%-30s %s\n"

Definition at line 6274 of file pbx.c.

Referenced by ast_pbx_hangup_handler_headers(), and ast_pbx_hangup_handler_show().

#define HASH_EXTENHINT_SIZE   563

Definition at line 1001 of file pbx.c.

Referenced by ast_pbx_init().

#define HINTDEVICE_DATA_LENGTH   16

Definition at line 994 of file pbx.c.

#define INC_DST_OVERFLOW_CHECK

Referenced by get_pattern_node().

#define NEW_MATCHER_CHK_MATCH

Referenced by new_find_extension().

#define NEW_MATCHER_RECURSE

Referenced by new_find_extension().

#define SAY_STUBS   /* generate declarations and stubs for say methods */

Definition at line 60 of file pbx.c.

#define STATUS_NO_CONTEXT   1

Definition at line 3092 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_NO_EXTENSION   2

Definition at line 3093 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_NO_LABEL   4

Definition at line 3095 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_NO_PRIORITY   3

Definition at line 3094 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_SUCCESS   5

Definition at line 3096 of file pbx.c.

Referenced by pbx_find_extension().

#define SWITCH_DATA_LENGTH   256

Definition at line 790 of file pbx.c.

#define VAR_BUF_SIZE   4096

Definition at line 792 of file pbx.c.

Referenced by ast_add_extension2_lockopt(), ast_func_read2(), pbx_builtin_importvar(), and pbx_substitute_variables_helper_full().

#define VAR_HARDTRAN   3

Definition at line 796 of file pbx.c.

#define VAR_NORMAL   1

Definition at line 794 of file pbx.c.

#define VAR_SOFTTRAN   2

Definition at line 795 of file pbx.c.

#define WAITEXTEN_DIALTONE   (1 << 1)

Definition at line 811 of file pbx.c.

Referenced by pbx_builtin_waitexten().

#define WAITEXTEN_MOH   (1 << 0)

Definition at line 810 of file pbx.c.

Referenced by pbx_builtin_waitexten().

---

Function Documentation

void __ast_context_destroy	(	struct ast_context *	list,
		struct ast_hashtab *	contexttab,
		struct ast_context *	con,
		const char *	registrar
	)

Definition at line 10768 of file pbx.c.

References __ast_internal_context_destroy(), ast_context::alts, ast_context_remove_extension_callerid2(), ast_copy_string(), ast_debug, ast_free, ast_hashtab_end_traversal(), ast_hashtab_next(), ast_hashtab_remove_this_object(), ast_hashtab_start_traversal(), AST_LIST_EMPTY, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_MAX_EXTENSION, ast_unlock_context(), ast_verb, ast_wrlock_context(), ast_exten::cidmatch, ast_exten::exten, ast_context::ignorepats, ast_context::includes, ast_exten::matchcid, ast_context::name, ast_include::next, ast_sw::next, ast_ignorepat::next, ast_context::next, ast_exten::peer_table, ast_exten::priority, ast_context::refcount, ast_exten::registrar, ast_include::registrar, ast_sw::registrar, ast_ignorepat::registrar, ast_context::registrar, ast_context::root, and ast_context::root_table.

Referenced by ast_context_destroy().

{
   struct ast_context *tmp, *tmpl=NULL;
   struct ast_exten *exten_item, *prio_item;

   for (tmp = list; tmp; ) {
      struct ast_context *next = NULL; /* next starting point */
         /* The following code used to skip forward to the next
            context with matching registrar, but this didn't
            make sense; individual priorities registrar'd to
            the matching registrar could occur in any context! */
      ast_debug(1, "Investigate ctx %s %s\n", tmp->name, tmp->registrar);
      if (con) {
         for (; tmp; tmpl = tmp, tmp = tmp->next) { /* skip to the matching context */
            ast_debug(1, "check ctx %s %s\n", tmp->name, tmp->registrar);
            if ( !strcasecmp(tmp->name, con->name) ) {
               break;   /* found it */
            }
         }
      }

      if (!tmp)   /* not found, we are done */
         break;
      ast_wrlock_context(tmp);

      if (registrar) {
         /* then search thru and remove any extens that match registrar. */
         struct ast_hashtab_iter *exten_iter;
         struct ast_hashtab_iter *prio_iter;
         struct ast_ignorepat *ip, *ipl = NULL, *ipn = NULL;
         struct ast_include *i, *pi = NULL, *ni = NULL;
         struct ast_sw *sw = NULL;

         /* remove any ignorepats whose registrar matches */
         for (ip = tmp->ignorepats; ip; ip = ipn) {
            ipn = ip->next;
            if (!strcmp(ip->registrar, registrar)) {
               if (ipl) {
                  ipl->next = ip->next;
                  ast_free(ip);
                  continue; /* don't change ipl */
               } else {
                  tmp->ignorepats = ip->next;
                  ast_free(ip);
                  continue; /* don't change ipl */
               }
            }
            ipl = ip;
         }
         /* remove any includes whose registrar matches */
         for (i = tmp->includes; i; i = ni) {
            ni = i->next;
            if (strcmp(i->registrar, registrar) == 0) {
               /* remove from list */
               if (pi) {
                  pi->next = i->next;
                  /* free include */
                  ast_free(i);
                  continue; /* don't change pi */
               } else {
                  tmp->includes = i->next;
                  /* free include */
                  ast_free(i);
                  continue; /* don't change pi */
               }
            }
            pi = i;
         }
         /* remove any switches whose registrar matches */
         AST_LIST_TRAVERSE_SAFE_BEGIN(&tmp->alts, sw, list) {
            if (strcmp(sw->registrar,registrar) == 0) {
               AST_LIST_REMOVE_CURRENT(list);
               ast_free(sw);
            }
         }
         AST_LIST_TRAVERSE_SAFE_END;

         if (tmp->root_table) { /* it is entirely possible that the context is EMPTY */
            exten_iter = ast_hashtab_start_traversal(tmp->root_table);
            while ((exten_item=ast_hashtab_next(exten_iter))) {
               int end_traversal = 1;
               prio_iter = ast_hashtab_start_traversal(exten_item->peer_table);
               while ((prio_item=ast_hashtab_next(prio_iter))) {
                  char extension[AST_MAX_EXTENSION];
                  char cidmatch[AST_MAX_EXTENSION];
                  if (!prio_item->registrar || strcmp(prio_item->registrar, registrar) != 0) {
                     continue;
                  }
                  ast_verb(3, "Remove %s/%s/%d, registrar=%s; con=%s(%p); con->root=%p\n",
                         tmp->name, prio_item->exten, prio_item->priority, registrar, con? con->name : "<nil>", con, con? con->root_table: NULL);
                  ast_copy_string(extension, prio_item->exten, sizeof(extension));
                  if (prio_item->cidmatch) {
                     ast_copy_string(cidmatch, prio_item->cidmatch, sizeof(cidmatch));
                  }
                  end_traversal &= ast_context_remove_extension_callerid2(tmp, extension, prio_item->priority, cidmatch, prio_item->matchcid, NULL, 1);
               }
               /* Explanation:
                * ast_context_remove_extension_callerid2 will destroy the extension that it comes across. This
                * destruction includes destroying the exten's peer_table, which we are currently traversing. If
                * ast_context_remove_extension_callerid2 ever should return '0' then this means we have destroyed
                * the hashtable which we are traversing, and thus calling ast_hashtab_end_traversal will result
                * in reading invalid memory. Thus, if we detect that we destroyed the hashtable, then we will simply
                * free the iterator
                */
               if (end_traversal) {
                  ast_hashtab_end_traversal(prio_iter);
               } else {
                  ast_free(prio_iter);
               }
            }
            ast_hashtab_end_traversal(exten_iter);
         }

         /* delete the context if it's registrar matches, is empty, has refcount of 1, */
         /* it's not empty, if it has includes, ignorepats, or switches that are registered from
            another registrar. It's not empty if there are any extensions */
         if (strcmp(tmp->registrar, registrar) == 0 && tmp->refcount < 2 && !tmp->root && !tmp->ignorepats && !tmp->includes && AST_LIST_EMPTY(&tmp->alts)) {
            ast_debug(1, "delete ctx %s %s\n", tmp->name, tmp->registrar);
            ast_hashtab_remove_this_object(contexttab, tmp);

            next = tmp->next;
            if (tmpl)
               tmpl->next = next;
            else
               contexts = next;
            /* Okay, now we're safe to let it go -- in a sense, we were
               ready to let it go as soon as we locked it. */
            ast_unlock_context(tmp);
            __ast_internal_context_destroy(tmp);
         } else {
            ast_debug(1,"Couldn't delete ctx %s/%s; refc=%d; tmp.root=%p\n", tmp->name, tmp->registrar,
                    tmp->refcount, tmp->root);
            ast_unlock_context(tmp);
            next = tmp->next;
            tmpl = tmp;
         }
      } else if (con) {
         ast_verb(3, "Deleting context %s registrar=%s\n", tmp->name, tmp->registrar);
         ast_debug(1, "delete ctx %s %s\n", tmp->name, tmp->registrar);
         ast_hashtab_remove_this_object(contexttab, tmp);

         next = tmp->next;
         if (tmpl)
            tmpl->next = next;
         else
            contexts = next;
         /* Okay, now we're safe to let it go -- in a sense, we were
            ready to let it go as soon as we locked it. */
         ast_unlock_context(tmp);
         __ast_internal_context_destroy(tmp);
      }

      /* if we have a specific match, we are done, otherwise continue */
      tmp = con ? NULL : next;
   }
}

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

Register a custom function.

Definition at line 4063 of file pbx.c.

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

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

{
   struct ast_custom_function *cur;
   char tmps[80];

   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);

   AST_RWLIST_TRAVERSE(&acf_root, cur, acflist) {
      if (!strcmp(acf->name, cur->name)) {
         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 (strcasecmp(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(2, "Registered custom function '%s'\n", term_color(tmps, acf->name, COLOR_BRCYAN, 0, sizeof(tmps)));

   return 0;
}

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 4111 of file pbx.c.

References __ast_custom_function_register(), ast_calloc, AST_CFE_BOTH, AST_CFE_NONE, AST_CFE_READ, AST_CFE_WRITE, ast_custom_function_unregister(), AST_RWLIST_INSERT_TAIL, AST_RWLIST_UNLOCK, and AST_RWLIST_WRLOCK.

{
   struct ast_custom_escalating_function *acf_escalation = NULL;
   int res;

   res = __ast_custom_function_register(acf, mod);
   if (res != 0) {
      return -1;
   }

   if (escalation == AST_CFE_NONE) {
      /* No escalations; no need to do anything else */
      return 0;
   }

   acf_escalation = ast_calloc(1, sizeof(*acf_escalation));
   if (!acf_escalation) {
      ast_custom_function_unregister(acf);
      return -1;
   }

   acf_escalation->acf = acf;
   switch (escalation) {
   case AST_CFE_NONE:
      break;
   case AST_CFE_READ:
      acf_escalation->read_escalates = 1;
      break;
   case AST_CFE_WRITE:
      acf_escalation->write_escalates = 1;
      break;
   case AST_CFE_BOTH:
      acf_escalation->read_escalates = 1;
      acf_escalation->write_escalates = 1;
      break;
   }

   AST_RWLIST_WRLOCK(&escalation_root);
   AST_RWLIST_INSERT_TAIL(&escalation_root, acf_escalation, list);
   AST_RWLIST_UNLOCK(&escalation_root);

   return 0;
}

static int __ast_goto_if_exists	(	struct ast_channel *	chan,
		const char *	context,
		const char *	exten,
		int	priority,
		int	async
	)		[static]

Definition at line 12262 of file pbx.c.

References ast_async_goto(), ast_channel_caller(), ast_channel_context(), ast_channel_exten(), ast_exists_extension(), ast_explicit_goto(), AST_PBX_GOTO_FAILED, context, exten, ast_channel::priority, and S_COR.

Referenced by ast_async_goto_if_exists(), and ast_goto_if_exists().

{
   int (*goto_func)(struct ast_channel *chan, const char *context, const char *exten, int priority);

   if (!chan)
      return -2;

   if (context == NULL)
      context = ast_channel_context(chan);
   if (exten == NULL)
      exten = ast_channel_exten(chan);

   goto_func = (async) ? ast_async_goto : ast_explicit_goto;
   if (ast_exists_extension(chan, context, exten, priority,
      S_COR(ast_channel_caller(chan)->id.number.valid, ast_channel_caller(chan)->id.number.str, NULL)))
      return goto_func(chan, context, exten, priority);
   else {
      return AST_PBX_GOTO_FAILED;
   }
}

static void __ast_internal_context_destroy

(

struct ast_context *

con

)

[static]

Definition at line 10720 of file pbx.c.

References ast_context::alts, ast_free, ast_hashtab_destroy(), AST_LIST_REMOVE_HEAD, ast_mutex_destroy, ast_rwlock_destroy, destroy_exten(), destroy_pattern_tree(), el, ast_context::ignorepats, ast_context::includes, ast_context::lock, ast_context::macrolock, ast_exten::next, ast_include::next, ast_ignorepat::next, ast_context::pattern_tree, ast_exten::peer, ast_context::registrar, ast_context::root, and ast_context::root_table.

Referenced by __ast_context_destroy(), and ast_merge_contexts_and_delete().

{
   struct ast_include *tmpi;
   struct ast_sw *sw;
   struct ast_exten *e, *el, *en;
   struct ast_ignorepat *ipi;
   struct ast_context *tmp = con;

   for (tmpi = tmp->includes; tmpi; ) { /* Free includes */
      struct ast_include *tmpil = tmpi;
      tmpi = tmpi->next;
      ast_free(tmpil);
   }
   for (ipi = tmp->ignorepats; ipi; ) { /* Free ignorepats */
      struct ast_ignorepat *ipl = ipi;
      ipi = ipi->next;
      ast_free(ipl);
   }
   if (tmp->registrar)
      ast_free(tmp->registrar);

   /* destroy the hash tabs */
   if (tmp->root_table) {
      ast_hashtab_destroy(tmp->root_table, 0);
   }
   /* and destroy the pattern tree */
   if (tmp->pattern_tree)
      destroy_pattern_tree(tmp->pattern_tree);

   while ((sw = AST_LIST_REMOVE_HEAD(&tmp->alts, list)))
      ast_free(sw);
   for (e = tmp->root; e;) {
      for (en = e->peer; en;) {
         el = en;
         en = en->peer;
         destroy_exten(el);
      }
      el = e;
      e = e->next;
      destroy_exten(el);
   }
   tmp->root = NULL;
   ast_rwlock_destroy(&tmp->lock);
   ast_mutex_destroy(&tmp->macrolock);
   ast_free(tmp);
}

static enum ast_pbx_result __ast_pbx_run	(	struct ast_channel *	c,
		struct ast_pbx_args *	args
	)		[static]

Note:

We get here on a failure of some kind: non-existing extension or hangup. We have options, here. We can either catch the failure and continue, or we can drop out entirely.

If there is no match at priority 1, it is not a valid extension anymore. Try to continue at "i" (for invalid) or "e" (for exception) or exit if neither exist.

Definition at line 6431 of file pbx.c.

References ast_callid_threadassoc_add(), ast_callid_unref, ast_calloc, ast_cdr_update(), ast_channel_caller(), ast_channel_callid(), ast_channel_callid_set(), ast_channel_cdr(), ast_channel_clear_softhangup(), ast_channel_context(), ast_channel_exten(), ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_pbx(), ast_channel_pbx_set(), ast_channel_priority(), ast_channel_priority_set(), ast_channel_softhangup_internal_flag(), ast_channel_unlock, ast_channel_whentohangup(), ast_check_hangup(), ast_clear_flag, ast_copy_string(), ast_create_callid(), ast_debug, ast_exists_extension(), AST_FLAG_BRIDGE_HANGUP_RUN, AST_FLAG_IN_AUTOLOOP, ast_free, ast_hangup(), ast_log(), ast_matchmore_extension(), AST_PBX_ERROR, ast_pbx_h_exten_run(), ast_pbx_hangup_handler_run(), AST_PBX_INCOMPLETE, ast_read_threadstorage_callid(), ast_set2_flag, ast_set_flag, ast_softhangup(), AST_SOFTHANGUP_APPUNLOAD, AST_SOFTHANGUP_ASYNCGOTO, AST_SOFTHANGUP_TIMEOUT, ast_spawn_extension(), ast_strlen_zero(), ast_test_flag, ast_verb, collect_digits(), ast_pbx::dtimeoutms, LOG_WARNING, ast_pbx_args::no_hangup_chan, pbx_builtin_busy(), pbx_builtin_congestion(), pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), pbx_destroy(), raise_exception(), ast_pbx::rtimeoutms, S_COR, set_ext_pri(), and status.

Referenced by ast_pbx_run_args(), and pbx_thread().

{
   int found = 0; /* set if we find at least one match */
   int res = 0;
   int autoloopflag;
   int error = 0;    /* set an error conditions */
   struct ast_pbx *pbx;
   struct ast_callid *callid;

   /* A little initial setup here */
   if (ast_channel_pbx(c)) {
      ast_log(LOG_WARNING, "%s already has PBX structure??\n", ast_channel_name(c));
      /* XXX and now what ? */
      ast_free(ast_channel_pbx(c));
   }
   if (!(pbx = ast_calloc(1, sizeof(*pbx)))) {
      return -1;
   }

   callid = ast_read_threadstorage_callid();
   /* If the thread isn't already associated with a callid, we should create that association. */
   if (!callid) {
      /* Associate new PBX thread with the channel call id if it is availble.
       * If not, create a new one instead.
       */
      callid = ast_channel_callid(c);
      if (!callid) {
         callid = ast_create_callid();
         if (callid) {
            ast_channel_callid_set(c, callid);
         }
      }
      ast_callid_threadassoc_add(callid);
      callid = ast_callid_unref(callid);
   } else {
      /* Nothing to do here, The thread is already bound to a callid.  Let's just get rid of the reference. */
      ast_callid_unref(callid);
   }

   ast_channel_pbx_set(c, pbx);
   /* Set reasonable defaults */
   ast_channel_pbx(c)->rtimeoutms = 10000;
   ast_channel_pbx(c)->dtimeoutms = 5000;

   autoloopflag = ast_test_flag(ast_channel_flags(c), AST_FLAG_IN_AUTOLOOP);  /* save value to restore at the end */
   ast_set_flag(ast_channel_flags(c), AST_FLAG_IN_AUTOLOOP);

   if (ast_strlen_zero(ast_channel_exten(c))) {
      /* If not successful fall back to 's' - but only if there is no given exten  */
      ast_verb(2, "Starting %s at %s,%s,%d failed so falling back to exten 's'\n", ast_channel_name(c), ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c));
      /* XXX the original code used the existing priority in the call to
       * ast_exists_extension(), and reset it to 1 afterwards.
       * I believe the correct thing is to set it to 1 immediately.
      */
      set_ext_pri(c, "s", 1);
   }

   ast_channel_lock(c);
   if (ast_channel_cdr(c)) {
      /* allow CDR variables that have been collected after channel was created to be visible during call */
      ast_cdr_update(c);
   }
   ast_channel_unlock(c);
   for (;;) {
      char dst_exten[256]; /* buffer to accumulate digits */
      int pos = 0;      /* XXX should check bounds */
      int digit = 0;
      int invalid = 0;
      int timeout = 0;

      /* No digits pressed yet */
      dst_exten[pos] = '\0';

      /* loop on priorities in this context/exten */
      while (!(res = ast_spawn_extension(c, ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c),
         S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL),
         &found, 1))) {
         if (!ast_check_hangup(c)) {
            ast_channel_priority_set(c, ast_channel_priority(c) + 1);
            continue;
         }

         /* Check softhangup flags. */
         if (ast_channel_softhangup_internal_flag(c) & AST_SOFTHANGUP_ASYNCGOTO) {
            ast_channel_clear_softhangup(c, AST_SOFTHANGUP_ASYNCGOTO);
            continue;
         }
         if (ast_channel_softhangup_internal_flag(c) & AST_SOFTHANGUP_TIMEOUT) {
            if (ast_exists_extension(c, ast_channel_context(c), "T", 1,
               S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
               set_ext_pri(c, "T", 1);
               /* If the AbsoluteTimeout is not reset to 0, we'll get an infinite loop */
               memset(ast_channel_whentohangup(c), 0, sizeof(*ast_channel_whentohangup(c)));
               ast_channel_clear_softhangup(c, AST_SOFTHANGUP_TIMEOUT);
               continue;
            } else if (ast_exists_extension(c, ast_channel_context(c), "e", 1,
               S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
               raise_exception(c, "ABSOLUTETIMEOUT", 1);
               /* If the AbsoluteTimeout is not reset to 0, we'll get an infinite loop */
               memset(ast_channel_whentohangup(c), 0, sizeof(*ast_channel_whentohangup(c)));
               ast_channel_clear_softhangup(c, AST_SOFTHANGUP_TIMEOUT);
               continue;
            }

            /* Call timed out with no special extension to jump to. */
            error = 1;
            break;
         }
         ast_debug(1, "Extension %s, priority %d returned normally even though call was hung up\n",
            ast_channel_exten(c), ast_channel_priority(c));
         error = 1;
         break;
      } /* end while  - from here on we can use 'break' to go out */
      if (found && res) {
         /* Something bad happened, or a hangup has been requested. */
         if (strchr("0123456789ABCDEF*#", res)) {
            ast_debug(1, "Oooh, got something to jump out with ('%c')!\n", res);
            pos = 0;
            dst_exten[pos++] = digit = res;
            dst_exten[pos] = '\0';
         } else if (res == AST_PBX_INCOMPLETE) {
            ast_debug(1, "Spawn extension (%s,%s,%d) exited INCOMPLETE on '%s'\n", ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c), ast_channel_name(c));
            ast_verb(2, "Spawn extension (%s, %s, %d) exited INCOMPLETE on '%s'\n", ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c), ast_channel_name(c));

            /* Don't cycle on incomplete - this will happen if the only extension that matches is our "incomplete" extension */
            if (!ast_matchmore_extension(c, ast_channel_context(c), ast_channel_exten(c), 1,
               S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
               invalid = 1;
            } else {
               ast_copy_string(dst_exten, ast_channel_exten(c), sizeof(dst_exten));
               digit = 1;
               pos = strlen(dst_exten);
            }
         } else {
            ast_debug(1, "Spawn extension (%s,%s,%d) exited non-zero on '%s'\n", ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c), ast_channel_name(c));
            ast_verb(2, "Spawn extension (%s, %s, %d) exited non-zero on '%s'\n", ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c), ast_channel_name(c));

            if ((res == AST_PBX_ERROR)
               && ast_exists_extension(c, ast_channel_context(c), "e", 1,
                  S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
               /* if we are already on the 'e' exten, don't jump to it again */
               if (!strcmp(ast_channel_exten(c), "e")) {
                  ast_verb(2, "Spawn extension (%s, %s, %d) exited ERROR while already on 'e' exten on '%s'\n", ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c), ast_channel_name(c));
                  error = 1;
               } else {
                  raise_exception(c, "ERROR", 1);
                  continue;
               }
            }

            if (ast_channel_softhangup_internal_flag(c) & AST_SOFTHANGUP_ASYNCGOTO) {
               ast_channel_clear_softhangup(c, AST_SOFTHANGUP_ASYNCGOTO);
               continue;
            }
            if (ast_channel_softhangup_internal_flag(c) & AST_SOFTHANGUP_TIMEOUT) {
               if (ast_exists_extension(c, ast_channel_context(c), "T", 1,
                  S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
                  set_ext_pri(c, "T", 1);
                  /* If the AbsoluteTimeout is not reset to 0, we'll get an infinite loop */
                  memset(ast_channel_whentohangup(c), 0, sizeof(*ast_channel_whentohangup(c)));
                  ast_channel_clear_softhangup(c, AST_SOFTHANGUP_TIMEOUT);
                  continue;
               } else if (ast_exists_extension(c, ast_channel_context(c), "e", 1,
                  S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
                  raise_exception(c, "ABSOLUTETIMEOUT", 1);
                  /* If the AbsoluteTimeout is not reset to 0, we'll get an infinite loop */
                  memset(ast_channel_whentohangup(c), 0, sizeof(*ast_channel_whentohangup(c)));
                  ast_channel_clear_softhangup(c, AST_SOFTHANGUP_TIMEOUT);
                  continue;
               }
               /* Call timed out with no special extension to jump to. */
            }
            ast_channel_lock(c);
            if (ast_channel_cdr(c)) {
               ast_cdr_update(c);
            }
            ast_channel_unlock(c);
            error = 1;
            break;
         }
      }
      if (error)
         break;

      /*!\note
       * We get here on a failure of some kind:  non-existing extension or
       * hangup.  We have options, here.  We can either catch the failure
       * and continue, or we can drop out entirely. */

      if (invalid
         || (ast_strlen_zero(dst_exten) &&
            !ast_exists_extension(c, ast_channel_context(c), ast_channel_exten(c), 1,
            S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL)))) {
         /*!\note
          * If there is no match at priority 1, it is not a valid extension anymore.
          * Try to continue at "i" (for invalid) or "e" (for exception) or exit if
          * neither exist.
          */
         if (ast_exists_extension(c, ast_channel_context(c), "i", 1,
            S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
            ast_verb(3, "Channel '%s' sent to invalid extension: context,exten,priority=%s,%s,%d\n",
               ast_channel_name(c), ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c));
            pbx_builtin_setvar_helper(c, "INVALID_EXTEN", ast_channel_exten(c));
            set_ext_pri(c, "i", 1);
         } else if (ast_exists_extension(c, ast_channel_context(c), "e", 1,
            S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
            raise_exception(c, "INVALID", 1);
         } else {
            ast_log(LOG_WARNING, "Channel '%s' sent to invalid extension but no invalid handler: context,exten,priority=%s,%s,%d\n",
               ast_channel_name(c), ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c));
            error = 1; /* we know what to do with it */
            break;
         }
      } else if (ast_channel_softhangup_internal_flag(c) & AST_SOFTHANGUP_TIMEOUT) {
         /* If we get this far with AST_SOFTHANGUP_TIMEOUT, then we know that the "T" extension is next. */
         ast_channel_clear_softhangup(c, AST_SOFTHANGUP_TIMEOUT);
      } else { /* keypress received, get more digits for a full extension */
         int waittime = 0;
         if (digit)
            waittime = ast_channel_pbx(c)->dtimeoutms;
         else if (!autofallthrough)
            waittime = ast_channel_pbx(c)->rtimeoutms;
         if (!waittime) {
            const char *status = pbx_builtin_getvar_helper(c, "DIALSTATUS");
            if (!status)
               status = "UNKNOWN";
            ast_verb(3, "Auto fallthrough, channel '%s' status is '%s'\n", ast_channel_name(c), status);
            if (!strcasecmp(status, "CONGESTION"))
               res = pbx_builtin_congestion(c, "10");
            else if (!strcasecmp(status, "CHANUNAVAIL"))
               res = pbx_builtin_congestion(c, "10");
            else if (!strcasecmp(status, "BUSY"))
               res = pbx_builtin_busy(c, "10");
            error = 1; /* XXX disable message */
            break;   /* exit from the 'for' loop */
         }

         if (collect_digits(c, waittime, dst_exten, sizeof(dst_exten), pos))
            break;
         if (res == AST_PBX_INCOMPLETE && ast_strlen_zero(&dst_exten[pos]))
            timeout = 1;
         if (!timeout
            && ast_exists_extension(c, ast_channel_context(c), dst_exten, 1,
               S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) { /* Prepare the next cycle */
            set_ext_pri(c, dst_exten, 1);
         } else {
            /* No such extension */
            if (!timeout && !ast_strlen_zero(dst_exten)) {
               /* An invalid extension */
               if (ast_exists_extension(c, ast_channel_context(c), "i", 1,
                  S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
                  ast_verb(3, "Invalid extension '%s' in context '%s' on %s\n", dst_exten, ast_channel_context(c), ast_channel_name(c));
                  pbx_builtin_setvar_helper(c, "INVALID_EXTEN", dst_exten);
                  set_ext_pri(c, "i", 1);
               } else if (ast_exists_extension(c, ast_channel_context(c), "e", 1,
                  S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
                  raise_exception(c, "INVALID", 1);
               } else {
                  ast_log(LOG_WARNING,
                     "Invalid extension '%s', but no rule 'i' or 'e' in context '%s'\n",
                     dst_exten, ast_channel_context(c));
                  found = 1; /* XXX disable message */
                  break;
               }
            } else {
               /* A simple timeout */
               if (ast_exists_extension(c, ast_channel_context(c), "t", 1,
                  S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
                  ast_verb(3, "Timeout on %s\n", ast_channel_name(c));
                  set_ext_pri(c, "t", 1);
               } else if (ast_exists_extension(c, ast_channel_context(c), "e", 1,
                  S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
                  raise_exception(c, "RESPONSETIMEOUT", 1);
               } else {
                  ast_log(LOG_WARNING,
                     "Timeout, but no rule 't' or 'e' in context '%s'\n",
                     ast_channel_context(c));
                  found = 1; /* XXX disable message */
                  break;
               }
            }
         }
         ast_channel_lock(c);
         if (ast_channel_cdr(c)) {
            ast_verb(2, "CDR updated on %s\n",ast_channel_name(c));
            ast_cdr_update(c);
         }
         ast_channel_unlock(c);
      }
   }

   if (!found && !error) {
      ast_log(LOG_WARNING, "Don't know what to do with '%s'\n", ast_channel_name(c));
   }

   if (!args || !args->no_hangup_chan) {
      ast_softhangup(c, AST_SOFTHANGUP_APPUNLOAD);
      if (!ast_test_flag(ast_channel_flags(c), AST_FLAG_BRIDGE_HANGUP_RUN)
         && ast_exists_extension(c, ast_channel_context(c), "h", 1,
            S_COR(ast_channel_caller(c)->id.number.valid,
               ast_channel_caller(c)->id.number.str, NULL))) {
         ast_pbx_h_exten_run(c, ast_channel_context(c));
      }
      ast_pbx_hangup_handler_run(c);
   }

   ast_set2_flag(ast_channel_flags(c), autoloopflag, AST_FLAG_IN_AUTOLOOP);
   ast_clear_flag(ast_channel_flags(c), AST_FLAG_BRIDGE_HANGUP_RUN); /* from one round to the next, make sure this gets cleared */
   pbx_destroy(ast_channel_pbx(c));
   ast_channel_pbx_set(c, NULL);

   if (!args || !args->no_hangup_chan) {
      ast_hangup(c);
   }

   return 0;
}

static void __init_extensionstate_buf

(

void

)

[static]

Definition at line 824 of file pbx.c.

{

static void __init_hintdevice_data

(

void

)

[static]

Definition at line 995 of file pbx.c.

{

static void __init_switch_data

(

void

)

[static]

Definition at line 823 of file pbx.c.

{

static void __init_thread_inhibit_escalations_tl

(

void

)

[static]

A thread local indicating whether the current thread can run 'dangerous' dialplan functions.

Definition at line 829 of file pbx.c.

{

static int _extension_match_core	(	const char *	pattern,
		const char *	data,
		enum ext_match_t	mode
	)		[static]

Definition at line 2836 of file pbx.c.

References ast_log(), ast_sw::data, E_MATCH, E_MATCH_MASK, E_MATCHMORE, ext_cmp_exten(), ext_cmp_exten_partial(), ext_cmp_exten_strlen(), ext_cmp_pattern(), LOG_NOTICE, and LOG_WARNING.

Referenced by extension_match_core().

{
   mode &= E_MATCH_MASK;   /* only consider the relevant bits */

#ifdef NEED_DEBUG_HERE
   ast_log(LOG_NOTICE,"match core: pat: '%s', dat: '%s', mode=%d\n", pattern, data, (int)mode);
#endif

   if (pattern[0] != '_') { /* not a pattern, try exact or partial match */
      int lp = ext_cmp_exten_strlen(pattern);
      int ld = ext_cmp_exten_strlen(data);

      if (lp < ld) {    /* pattern too short, cannot match */
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"return (0) - pattern too short, cannot match\n");
#endif
         return 0;
      }
      /* depending on the mode, accept full or partial match or both */
      if (mode == E_MATCH) {
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"return (!ext_cmp_exten(%s,%s) when mode== E_MATCH)\n", pattern, data);
#endif
         return !ext_cmp_exten(pattern, data); /* 1 on match, 0 on fail */
      }
      if (ld == 0 || !ext_cmp_exten_partial(pattern, data)) { /* partial or full match */
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"return (mode(%d) == E_MATCHMORE ? lp(%d) > ld(%d) : 1)\n", mode, lp, ld);
#endif
         return (mode == E_MATCHMORE) ? lp > ld : 1; /* XXX should consider '!' and '/' ? */
      } else {
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"return (0) when ld(%d) > 0 && pattern(%s) != data(%s)\n", ld, pattern, data);
#endif
         return 0;
      }
   }
   if (mode == E_MATCH && data[0] == '_') {
      /*
       * XXX It is bad design that we don't know if we should be
       * comparing data and pattern as patterns or comparing data if
       * it conforms to pattern when the function is called.  First,
       * assume they are both patterns.  If they don't match then try
       * to see if data conforms to the given pattern.
       *
       * note: if this test is left out, then _x. will not match _x. !!!
       */
#ifdef NEED_DEBUG_HERE
      ast_log(LOG_NOTICE, "Comparing as patterns first. pattern:%s data:%s\n", pattern, data);
#endif
      if (!ext_cmp_pattern(pattern + 1, data + 1)) {
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"return (1) - pattern matches pattern\n");
#endif
         return 1;
      }
   }

   ++pattern; /* skip leading _ */
   /*
    * XXX below we stop at '/' which is a separator for the CID info. However we should
    * not store '/' in the pattern at all. When we insure it, we can remove the checks.
    */
   for (;;) {
      const char *end;

      /* Ignore '-' chars as eye candy fluff. */
      while (*data == '-') {
         ++data;
      }
      while (*pattern == '-') {
         ++pattern;
      }
      if (!*data || !*pattern || *pattern == '/') {
         break;
      }

      switch (*pattern) {
      case '[':   /* a range */
         ++pattern;
         end = strchr(pattern, ']'); /* XXX should deal with escapes ? */
         if (!end) {
            ast_log(LOG_WARNING, "Wrong usage of [] in the extension\n");
            return 0;   /* unconditional failure */
         }
         if (pattern == end) {
            /* Ignore empty character sets. */
            ++pattern;
            continue;
         }
         for (; pattern < end; ++pattern) {
            if (pattern+2 < end && pattern[1] == '-') { /* this is a range */
               if (*data >= pattern[0] && *data <= pattern[2])
                  break;   /* match found */
               else {
                  pattern += 2; /* skip a total of 3 chars */
                  continue;
               }
            } else if (*data == pattern[0])
               break;   /* match found */
         }
         if (pattern >= end) {
#ifdef NEED_DEBUG_HERE
            ast_log(LOG_NOTICE,"return (0) when pattern>=end\n");
#endif
            return 0;
         }
         pattern = end; /* skip and continue */
         break;
      case 'n':
      case 'N':
         if (*data < '2' || *data > '9') {
#ifdef NEED_DEBUG_HERE
            ast_log(LOG_NOTICE,"return (0) N is not matched\n");
#endif
            return 0;
         }
         break;
      case 'x':
      case 'X':
         if (*data < '0' || *data > '9') {
#ifdef NEED_DEBUG_HERE
            ast_log(LOG_NOTICE,"return (0) X is not matched\n");
#endif
            return 0;
         }
         break;
      case 'z':
      case 'Z':
         if (*data < '1' || *data > '9') {
#ifdef NEED_DEBUG_HERE
            ast_log(LOG_NOTICE,"return (0) Z is not matched\n");
#endif
            return 0;
         }
         break;
      case '.':   /* Must match, even with more digits */
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE, "return (1) when '.' is matched\n");
#endif
         return 1;
      case '!':   /* Early match */
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE, "return (2) when '!' is matched\n");
#endif
         return 2;
      default:
         if (*data != *pattern) {
#ifdef NEED_DEBUG_HERE
            ast_log(LOG_NOTICE, "return (0) when *data(%c) != *pattern(%c)\n", *data, *pattern);
#endif
            return 0;
         }
         break;
      }
      ++data;
      ++pattern;
   }
   if (*data)        /* data longer than pattern, no match */ {
#ifdef NEED_DEBUG_HERE
      ast_log(LOG_NOTICE, "return (0) when data longer than pattern\n");
#endif
      return 0;
   }

   /*
    * match so far, but ran off the end of data.
    * Depending on what is next, determine match or not.
    */
   if (*pattern == '\0' || *pattern == '/') {   /* exact match */
#ifdef NEED_DEBUG_HERE
      ast_log(LOG_NOTICE, "at end, return (%d) in 'exact match'\n", (mode==E_MATCHMORE) ? 0 : 1);
#endif
      return (mode == E_MATCHMORE) ? 0 : 1;  /* this is a failure for E_MATCHMORE */
   } else if (*pattern == '!')   {     /* early match */
#ifdef NEED_DEBUG_HERE
      ast_log(LOG_NOTICE, "at end, return (2) when '!' is matched\n");
#endif
      return 2;
   } else {                /* partial match */
#ifdef NEED_DEBUG_HERE
      ast_log(LOG_NOTICE, "at end, return (%d) which deps on E_MATCH\n", (mode == E_MATCH) ? 0 : 1);
#endif
      return (mode == E_MATCH) ? 0 : 1;   /* this is a failure for E_MATCH */
   }
}

static int acf_exception_read	(	struct ast_channel *	chan,
		const char *	name,
		char *	data,
		char *	buf,
		size_t	buflen
	)		[static]

Definition at line 3743 of file pbx.c.

References ast_channel_datastore_find(), ast_copy_string(), pbx_exception::context, ast_datastore::data, exception_store_info, pbx_exception::exten, pbx_exception::priority, and pbx_exception::reason.

{
   struct ast_datastore *ds = ast_channel_datastore_find(chan, &exception_store_info, NULL);
   struct pbx_exception *exception = NULL;
   if (!ds || !ds->data)
      return -1;
   exception = ds->data;
   if (!strcasecmp(data, "REASON"))
      ast_copy_string(buf, exception->reason, buflen);
   else if (!strcasecmp(data, "CONTEXT"))
      ast_copy_string(buf, exception->context, buflen);
   else if (!strncasecmp(data, "EXTEN", 5))
      ast_copy_string(buf, exception->exten, buflen);
   else if (!strcasecmp(data, "PRIORITY"))
      snprintf(buf, buflen, "%d", exception->priority);
   else
      return -1;
   return 0;
}

static int acf_retrieve_docs

(

struct ast_custom_function *

acf

)

[static]

Definition at line 4018 of file pbx.c.

References ast_free, ast_module_name(), ast_string_field_init, ast_string_field_set, ast_strlen_zero(), AST_XML_DOC, ast_xmldoc_build_arguments(), ast_xmldoc_build_description(), ast_xmldoc_build_seealso(), ast_xmldoc_build_synopsis(), ast_xmldoc_build_syntax(), desc, ast_custom_function::desc, ast_custom_function::docsrc, ast_custom_function::mod, ast_custom_function::name, ast_custom_function::synopsis, and synopsis.

Referenced by __ast_custom_function_register().

{
#ifdef AST_XML_DOCS
   char *tmpxml;

   /* Let's try to find it in the Documentation XML */
   if (!ast_strlen_zero(acf->desc) || !ast_strlen_zero(acf->synopsis)) {
      return 0;
   }

   if (ast_string_field_init(acf, 128)) {
      return -1;
   }

   /* load synopsis */
   tmpxml = ast_xmldoc_build_synopsis("function", acf->name, ast_module_name(acf->mod));
   ast_string_field_set(acf, synopsis, tmpxml);
   ast_free(tmpxml);

   /* load description */
   tmpxml = ast_xmldoc_build_description("function", acf->name, ast_module_name(acf->mod));
   ast_string_field_set(acf, desc, tmpxml);
   ast_free(tmpxml);

   /* load syntax */
   tmpxml = ast_xmldoc_build_syntax("function", acf->name, ast_module_name(acf->mod));
   ast_string_field_set(acf, syntax, tmpxml);
   ast_free(tmpxml);

   /* load arguments */
   tmpxml = ast_xmldoc_build_arguments("function", acf->name, ast_module_name(acf->mod));
   ast_string_field_set(acf, arguments, tmpxml);
   ast_free(tmpxml);

   /* load seealso */
   tmpxml = ast_xmldoc_build_seealso("function", acf->name, ast_module_name(acf->mod));
   ast_string_field_set(acf, seealso, tmpxml);
   ast_free(tmpxml);

   acf->docsrc = AST_XML_DOC;
#endif

   return 0;
}

static struct match_char * add_exten_to_pattern_tree	(	struct ast_context *	con,
		struct ast_exten *	e1,
		int	findonly
	)		[static, read]

Definition at line 2319 of file pbx.c.

References add_pattern_node(), already_in_tree(), ARRAY_LEN, ast_copy_string(), ast_debug, ast_log(), pattern_node::buf, ast_exten::cidmatch, match_char::deleted, ast_exten::exten, match_char::exten, get_pattern_node(), LOG_ERROR, LOG_WARNING, ast_exten::matchcid, match_char::next_char, and ast_context::pattern_tree.

Referenced by add_priority(), ast_add_extension2_lockopt(), ast_context_remove_extension_callerid2(), and create_match_char_tree().

{
   struct match_char *m1 = NULL;
   struct match_char *m2 = NULL;
   struct match_char **m0;
   const char *pos;
   int already;
   int pattern = 0;
   int idx_cur;
   int idx_next;
   char extenbuf[512];
   struct pattern_node pat_node[2];

   if (e1->matchcid) {
      if (sizeof(extenbuf) < strlen(e1->exten) + strlen(e1->cidmatch) + 2) {
         ast_log(LOG_ERROR,
            "The pattern %s/%s is too big to deal with: it will be ignored! Disaster!\n",
            e1->exten, e1->cidmatch);
         return NULL;
      }
      sprintf(extenbuf, "%s/%s", e1->exten, e1->cidmatch);/* Safe.  We just checked. */
   } else {
      ast_copy_string(extenbuf, e1->exten, sizeof(extenbuf));
   }

#ifdef NEED_DEBUG
   ast_debug(1, "Adding exten %s to tree\n", extenbuf);
#endif
   m1 = con->pattern_tree; /* each pattern starts over at the root of the pattern tree */
   m0 = &con->pattern_tree;
   already = 1;

   pos = extenbuf;
   if (*pos == '_') {
      pattern = 1;
      ++pos;
   }
   idx_cur = 0;
   pos = get_pattern_node(&pat_node[idx_cur], pos, pattern, extenbuf);
   for (; pat_node[idx_cur].buf[0]; idx_cur = idx_next) {
      idx_next = (idx_cur + 1) % ARRAY_LEN(pat_node);
      pos = get_pattern_node(&pat_node[idx_next], pos, pattern, extenbuf);

      /* See about adding node to tree. */
      m2 = NULL;
      if (already && (m2 = already_in_tree(m1, pat_node[idx_cur].buf, pattern))
         && m2->next_char) {
         if (!pat_node[idx_next].buf[0]) {
            /*
             * This is the end of the pattern, but not the end of the tree.
             * Mark this node with the exten... a shorter pattern might win
             * if the longer one doesn't match.
             */
            if (findonly) {
               return m2;
            }
            if (m2->exten) {
               ast_log(LOG_WARNING, "Found duplicate exten. Had %s found %s\n",
                  m2->deleted ? "(deleted/invalid)" : m2->exten->exten, e1->exten);
            }
            m2->exten = e1;
            m2->deleted = 0;
         }
         m1 = m2->next_char; /* m1 points to the node to compare against */
         m0 = &m2->next_char; /* m0 points to the ptr that points to m1 */
      } else { /* not already OR not m2 OR nor m2->next_char */
         if (m2) {
            if (findonly) {
               return m2;
            }
            m1 = m2; /* while m0 stays the same */
         } else {
            if (findonly) {
               return m1;
            }
            m1 = add_pattern_node(con, m1, &pat_node[idx_cur], pattern, already, m0);
            if (!m1) { /* m1 is the node just added */
               return NULL;
            }
            m0 = &m1->next_char;
         }
         if (!pat_node[idx_next].buf[0]) {
            if (m2 && m2->exten) {
               ast_log(LOG_WARNING, "Found duplicate exten. Had %s found %s\n",
                  m2->deleted ? "(deleted/invalid)" : m2->exten->exten, e1->exten);
            }
            m1->deleted = 0;
            m1->exten = e1;
         }

         /* The 'already' variable is a mini-optimization designed to make it so that we
          * don't have to call already_in_tree when we know it will return false.
          */
         already = 0;
      }
   }
   return m1;
}

static int add_hintdevice	(	struct ast_hint *	hint,
		const char *	devicelist
	)		[static]

add hintdevice structure and link it into the container.

Definition at line 1086 of file pbx.c.

References ao2_ref, ao2_t_alloc, ao2_t_link, ao2_t_ref, ast_str_set(), ast_str_thread_get(), ast_hintdevice::hint, ast_hintdevice::hintdevice, hintdevice_data, hintdevice_destroy(), parse(), parse_hint_device(), and str.

Referenced by ast_add_hint(), and ast_change_hint().

{
   struct ast_str *str;
   char *parse;
   char *cur;
   struct ast_hintdevice *device;
   int devicelength;

   if (!hint || !devicelist) {
      /* Trying to add garbage? Don't bother. */
      return 0;
   }
   if (!(str = ast_str_thread_get(&hintdevice_data, 16))) {
      return -1;
   }
   ast_str_set(&str, 0, "%s", devicelist);
   parse = parse_hint_device(str);

   while ((cur = strsep(&parse, "&"))) {
      devicelength = strlen(cur);
      device = ao2_t_alloc(sizeof(*device) + devicelength, hintdevice_destroy,
         "allocating a hintdevice structure");
      if (!device) {
         return -1;
      }
      strcpy(device->hintdevice, cur);
      ao2_ref(hint, +1);
      device->hint = hint;
      ao2_t_link(hintdevices, device, "Linking device into hintdevice container.");
      ao2_t_ref(device, -1, "hintdevice is linked so we can unref");
   }

   return 0;
}

static struct match_char* add_pattern_node	(	struct ast_context *	con,
		struct match_char *	current,
		const struct pattern_node *	pattern,
		int	is_pattern,
		int	already,
		struct match_char **	nextcharptr
	)		[static, read]

Definition at line 2121 of file pbx.c.

References ast_calloc, pattern_node::buf, insert_in_next_chars_alt_char_list(), match_char::is_pattern, match_char::next_char, ast_context::pattern_tree, pattern_node::specif, match_char::specificity, and match_char::x.

Referenced by add_exten_to_pattern_tree().

{
   struct match_char *m;

   if (!(m = ast_calloc(1, sizeof(*m) + strlen(pattern->buf)))) {
      return NULL;
   }

   /* strcpy is safe here since we know its size and have allocated
    * just enough space for when we allocated m
    */
   strcpy(m->x, pattern->buf);

   /* the specificity scores are the same as used in the old
      pattern matcher. */
   m->is_pattern = is_pattern;
   if (pattern->specif == 1 && is_pattern && pattern->buf[0] == 'N') {
      m->specificity = 0x0832;
   } else if (pattern->specif == 1 && is_pattern && pattern->buf[0] == 'Z') {
      m->specificity = 0x0931;
   } else if (pattern->specif == 1 && is_pattern && pattern->buf[0] == 'X') {
      m->specificity = 0x0a30;
   } else if (pattern->specif == 1 && is_pattern && pattern->buf[0] == '.') {
      m->specificity = 0x18000;
   } else if (pattern->specif == 1 && is_pattern && pattern->buf[0] == '!') {
      m->specificity = 0x28000;
   } else {
      m->specificity = pattern->specif;
   }

   if (!con->pattern_tree) {
      insert_in_next_chars_alt_char_list(&con->pattern_tree, m);
   } else {
      if (already) { /* switch to the new regime (traversing vs appending)*/
         insert_in_next_chars_alt_char_list(nextcharptr, m);
      } else {
         insert_in_next_chars_alt_char_list(&current->next_char, m);
      }
   }

   return m;
}

static int add_priority	(	struct ast_context *	con,
		struct ast_exten *	tmp,
		struct ast_exten *	el,
		struct ast_exten *	e,
		int	replace
	)		[static]

add the extension in the priority chain.

Return values:

0	on success.
-1	on failure.

Definition at line 9829 of file pbx.c.

References add_exten_to_pattern_tree(), ast_add_hint(), ast_change_hint(), ast_free, ast_hashtab_insert_safe(), ast_hashtab_remove_object_via_lookup(), ast_log(), ast_exten::data, ast_exten::datad, ast_exten::exten, match_char::exten, ast_exten::label, LOG_ERROR, LOG_WARNING, ast_context::name, ast_exten::next, ast_exten::peer, ast_exten::peer_label_table, ast_exten::peer_table, ast_exten::priority, PRIORITY_HINT, ast_context::root, ast_context::root_table, and match_char::x.

Referenced by ast_add_extension2_lockopt().

{
   struct ast_exten *ep;
   struct ast_exten *eh=e;
   int repeated_label = 0; /* Track if this label is a repeat, assume no. */

   for (ep = NULL; e ; ep = e, e = e->peer) {
      if (e->label && tmp->label && e->priority != tmp->priority && !strcmp(e->label, tmp->label)) {
         if (strcmp(e->exten, tmp->exten)) {
            ast_log(LOG_WARNING,
               "Extension '%s' priority %d in '%s', label '%s' already in use at aliased extension '%s' priority %d\n",
               tmp->exten, tmp->priority, con->name, tmp->label, e->exten, e->priority);
         } else {
            ast_log(LOG_WARNING,
               "Extension '%s' priority %d in '%s', label '%s' already in use at priority %d\n",
               tmp->exten, tmp->priority, con->name, tmp->label, e->priority);
         }
         repeated_label = 1;
      }
      if (e->priority >= tmp->priority) {
         break;
      }
   }

   if (repeated_label) {   /* Discard the label since it's a repeat. */
      tmp->label = NULL;
   }

   if (!e) {   /* go at the end, and ep is surely set because the list is not empty */
      ast_hashtab_insert_safe(eh->peer_table, tmp);

      if (tmp->label) {
         ast_hashtab_insert_safe(eh->peer_label_table, tmp);
      }
      ep->peer = tmp;
      return 0;   /* success */
   }
   if (e->priority == tmp->priority) {
      /* Can't have something exactly the same.  Is this a
         replacement?  If so, replace, otherwise, bonk. */
      if (!replace) {
         if (strcmp(e->exten, tmp->exten)) {
            ast_log(LOG_WARNING,
               "Unable to register extension '%s' priority %d in '%s', already in use by aliased extension '%s'\n",
               tmp->exten, tmp->priority, con->name, e->exten);
         } else {
            ast_log(LOG_WARNING,
               "Unable to register extension '%s' priority %d in '%s', already in use\n",
               tmp->exten, tmp->priority, con->name);
         }
         if (tmp->datad) {
            tmp->datad(tmp->data);
            /* if you free this, null it out */
            tmp->data = NULL;
         }

         ast_free(tmp);
         return -1;
      }
      /* we are replacing e, so copy the link fields and then update
       * whoever pointed to e to point to us
       */
      tmp->next = e->next; /* not meaningful if we are not first in the peer list */
      tmp->peer = e->peer; /* always meaningful */
      if (ep)  {     /* We're in the peer list, just insert ourselves */
         ast_hashtab_remove_object_via_lookup(eh->peer_table,e);

         if (e->label) {
            ast_hashtab_remove_object_via_lookup(eh->peer_label_table,e);
         }

         ast_hashtab_insert_safe(eh->peer_table,tmp);
         if (tmp->label) {
            ast_hashtab_insert_safe(eh->peer_label_table,tmp);
         }

         ep->peer = tmp;
      } else if (el) {     /* We're the first extension. Take over e's functions */
         struct match_char *x = add_exten_to_pattern_tree(con, e, 1);
         tmp->peer_table = e->peer_table;
         tmp->peer_label_table = e->peer_label_table;
         ast_hashtab_remove_object_via_lookup(tmp->peer_table,e);
         ast_hashtab_insert_safe(tmp->peer_table,tmp);
         if (e->label) {
            ast_hashtab_remove_object_via_lookup(tmp->peer_label_table, e);
         }
         if (tmp->label) {
            ast_hashtab_insert_safe(tmp->peer_label_table, tmp);
         }

         ast_hashtab_remove_object_via_lookup(con->root_table, e);
         ast_hashtab_insert_safe(con->root_table, tmp);
         el->next = tmp;
         /* The pattern trie points to this exten; replace the pointer,
            and all will be well */
         if (x) { /* if the trie isn't formed yet, don't sweat this */
            if (x->exten) { /* this test for safety purposes */
               x->exten = tmp; /* replace what would become a bad pointer */
            } else {
               ast_log(LOG_ERROR,"Trying to delete an exten from a context, but the pattern tree node returned isn't an extension\n");
            }
         }
      } else {       /* We're the very first extension.  */
         struct match_char *x = add_exten_to_pattern_tree(con, e, 1);
         ast_hashtab_remove_object_via_lookup(con->root_table, e);
         ast_hashtab_insert_safe(con->root_table, tmp);
         tmp->peer_table = e->peer_table;
         tmp->peer_label_table = e->peer_label_table;
         ast_hashtab_remove_object_via_lookup(tmp->peer_table, e);
         ast_hashtab_insert_safe(tmp->peer_table, tmp);
         if (e->label) {
            ast_hashtab_remove_object_via_lookup(tmp->peer_label_table, e);
         }
         if (tmp->label) {
            ast_hashtab_insert_safe(tmp->peer_label_table, tmp);
         }

         ast_hashtab_remove_object_via_lookup(con->root_table, e);
         ast_hashtab_insert_safe(con->root_table, tmp);
         con->root = tmp;
         /* The pattern trie points to this exten; replace the pointer,
            and all will be well */
         if (x) { /* if the trie isn't formed yet; no problem */
            if (x->exten) { /* this test for safety purposes */
               x->exten = tmp; /* replace what would become a bad pointer */
            } else {
               ast_log(LOG_ERROR,"Trying to delete an exten from a context, but the pattern tree node returned isn't an extension\n");
            }
         }
      }
      if (tmp->priority == PRIORITY_HINT)
         ast_change_hint(e,tmp);
      /* Destroy the old one */
      if (e->datad)
         e->datad(e->data);
      ast_free(e);
   } else { /* Slip ourselves in just before e */
      tmp->peer = e;
      tmp->next = e->next; /* extension chain, or NULL if e is not the first extension */
      if (ep) {         /* Easy enough, we're just in the peer list */
         if (tmp->label) {
            ast_hashtab_insert_safe(eh->peer_label_table, tmp);
         }
         ast_hashtab_insert_safe(eh->peer_table, tmp);
         ep->peer = tmp;
      } else {       /* we are the first in some peer list, so link in the ext list */
         tmp->peer_table = e->peer_table;
         tmp->peer_label_table = e->peer_label_table;
         e->peer_table = 0;
         e->peer_label_table = 0;
         ast_hashtab_insert_safe(tmp->peer_table, tmp);
         if (tmp->label) {
            ast_hashtab_insert_safe(tmp->peer_label_table, tmp);
         }
         ast_hashtab_remove_object_via_lookup(con->root_table, e);
         ast_hashtab_insert_safe(con->root_table, tmp);
         if (el)
            el->next = tmp;   /* in the middle... */
         else
            con->root = tmp; /* ... or at the head */
         e->next = NULL;   /* e is no more at the head, so e->next must be reset */
      }
      /* And immediately return success. */
      if (tmp->priority == PRIORITY_HINT) {
         ast_add_hint(tmp);
      }
   }
   return 0;
}

static struct ao2_container* alloc_device_state_info

(

void

)

[static, read]

Definition at line 5044 of file pbx.c.

References AO2_ALLOC_OPT_LOCK_NOLOCK, and ao2_container_alloc_options.

Referenced by ast_extension_state_extended(), and handle_statechange().

{
   return ao2_container_alloc_options(AO2_ALLOC_OPT_LOCK_NOLOCK, 1, NULL, NULL);
}

static struct match_char * already_in_tree	(	struct match_char *	current,
		char *	pat,
		int	is_pattern
	)		[static, read]

Definition at line 2059 of file pbx.c.

References match_char::alt_char, match_char::is_pattern, and match_char::x.

Referenced by add_exten_to_pattern_tree().

{
   struct match_char *t;

   if (!current) {
      return 0;
   }

   for (t = current; t; t = t->alt_char) {
      if (is_pattern == t->is_pattern && !strcmp(pat, t->x)) {/* uh, we may want to sort exploded [] contents to make matching easy */
         return t;
      }
   }

   return 0;
}

int ast_active_calls

(

void

)

Retrieve the number of active calls.

Definition at line 6896 of file pbx.c.

References countcalls.

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

{
   return countcalls;
}

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
registrar	who registered the extension

Return values:

0	success
-1	failure

Definition at line 9663 of file pbx.c.

References ast_add_extension2(), ast_unlock_contexts(), and find_context_locked().

Referenced by ast_hint_presence_state(), extension_state_add_destroy(), handle_cli_dialplan_add_extension(), internal_extension_state_extended(), manage_parked_call(), park_add_hints(), park_call_full(), parkinglot_activate(), register_exten(), register_extension(), and register_peer_exten().

{
   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);
      ast_unlock_contexts();
   }

   return ret;
}

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
	)

Main interface to add extensions to the list for out context.

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 10025 of file pbx.c.

References ast_add_extension2_lockopt().

Referenced by add_extensions(), ast_add_extension(), context_merge(), lua_register_hints(), pbx_load_config(), pbx_load_users(), sla_build_station(), and sla_build_trunk().

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

static int ast_add_extension2_lockopt	(	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,
		int	lock_context
	)		[static]

Same as ast_add_extension2() but controls the context locking.

Does all the work of ast_add_extension2, but adds an arg to determine if context locking should be done.

Definition at line 10041 of file pbx.c.

References add_exten_to_pattern_tree(), add_priority(), ast_exten::app, ast_add_hint(), ast_calloc, ast_channel_context_set(), ast_channel_exten_set(), ast_channel_unref, ast_copy_string(), ast_debug, ast_dummy_channel_alloc(), AST_EXT_MATCHCID_OFF, AST_EXT_MATCHCID_ON, ast_hashtab_create(), ast_hashtab_insert_safe(), ast_hashtab_lookup(), ast_hashtab_newsize_java(), ast_hashtab_resize_java(), ast_log(), ast_strlen_zero(), ast_unlock_context(), ast_verb, ast_wrlock_context(), ast_exten::cidmatch, ast_exten::data, ast_sw::data, ast_exten::datad, el, errno, ext_cmp(), ext_strncpy(), ast_exten::exten, hashtab_compare_exten_labels(), hashtab_compare_exten_numbers(), hashtab_compare_extens(), hashtab_hash_extens(), hashtab_hash_labels(), hashtab_hash_priority(), ast_exten::label, LOG_ERROR, ast_exten::matchcid, ast_context::name, ast_exten::next, option_debug, ast_exten::parent, ast_context::pattern_tree, pbx_substitute_variables_helper(), ast_exten::peer_label_table, ast_exten::peer_table, ast_exten::priority, PRIORITY_HINT, ast_exten::registrar, ast_sw::registrar, ast_context::root, ast_context::root_table, ast_exten::stuff, and VAR_BUF_SIZE.

Referenced by ast_add_extension2(), and ast_add_extension_nolock().

{
   /*
    * Sort extensions (or patterns) according to the rules indicated above.
    * These are implemented by the function ext_cmp()).
    * All priorities for the same ext/pattern/cid are kept in a list,
    * using the 'peer' field  as a link field..
    */
   struct ast_exten *tmp, *tmp2, *e, *el = NULL;
   int res;
   int length;
   char *p;
   char expand_buf[VAR_BUF_SIZE];
   struct ast_exten dummy_exten = {0};
   char dummy_name[1024];

   if (ast_strlen_zero(extension)) {
      ast_log(LOG_ERROR,"You have to be kidding-- add exten '' to context %s? Figure out a name and call me back. Action ignored.\n",
            con->name);
      return -1;
   }

   /* If we are adding a hint evalulate in variables and global variables */
   if (priority == PRIORITY_HINT && strstr(application, "${") && extension[0] != '_') {
      struct ast_channel *c = ast_dummy_channel_alloc();

      if (c) {
         ast_channel_exten_set(c, extension);
         ast_channel_context_set(c, con->name);
      }
      pbx_substitute_variables_helper(c, application, expand_buf, sizeof(expand_buf));
      application = expand_buf;
      if (c) {
         ast_channel_unref(c);
      }
   }

   length = sizeof(struct ast_exten);
   length += strlen(extension) + 1;
   length += strlen(application) + 1;
   if (label)
      length += strlen(label) + 1;
   if (callerid)
      length += strlen(callerid) + 1;
   else
      length ++;  /* just the '\0' */

   /* Be optimistic:  Build the extension structure first */
   if (!(tmp = ast_calloc(1, length)))
      return -1;

   if (ast_strlen_zero(label)) /* let's turn empty labels to a null ptr */
      label = 0;

   /* use p as dst in assignments, as the fields are const char * */
   p = tmp->stuff;
   if (label) {
      tmp->label = p;
      strcpy(p, label);
      p += strlen(label) + 1;
   }
   tmp->exten = p;
   p += ext_strncpy(p, extension, strlen(extension) + 1) + 1;
   tmp->priority = priority;
   tmp->cidmatch = p;   /* but use p for assignments below */

   /* Blank callerid and NULL callerid are two SEPARATE things.  Do NOT confuse the two!!! */
   if (callerid) {
      p += ext_strncpy(p, callerid, strlen(callerid) + 1) + 1;
      tmp->matchcid = AST_EXT_MATCHCID_ON;
   } else {
      *p++ = '\0';
      tmp->matchcid = AST_EXT_MATCHCID_OFF;
   }
   tmp->app = p;
   strcpy(p, application);
   tmp->parent = con;
   tmp->data = data;
   tmp->datad = datad;
   tmp->registrar = registrar;

   if (lock_context) {
      ast_wrlock_context(con);
   }

   if (con->pattern_tree) { /* usually, on initial load, the pattern_tree isn't formed until the first find_exten; so if we are adding
                        an extension, and the trie exists, then we need to incrementally add this pattern to it. */
      ast_copy_string(dummy_name, extension, sizeof(dummy_name));
      dummy_exten.exten = dummy_name;
      dummy_exten.matchcid = AST_EXT_MATCHCID_OFF;
      dummy_exten.cidmatch = 0;
      tmp2 = ast_hashtab_lookup(con->root_table, &dummy_exten);
      if (!tmp2) {
         /* hmmm, not in the trie; */
         add_exten_to_pattern_tree(con, tmp, 0);
         ast_hashtab_insert_safe(con->root_table, tmp); /* for the sake of completeness */
      }
   }
   res = 0; /* some compilers will think it is uninitialized otherwise */
   for (e = con->root; e; el = e, e = e->next) {   /* scan the extension list */
      res = ext_cmp(e->exten, tmp->exten);
      if (res == 0) { /* extension match, now look at cidmatch */
         if (e->matchcid == AST_EXT_MATCHCID_OFF && tmp->matchcid == AST_EXT_MATCHCID_OFF)
            res = 0;
         else if (tmp->matchcid == AST_EXT_MATCHCID_ON && e->matchcid == AST_EXT_MATCHCID_OFF)
            res = 1;
         else if (e->matchcid == AST_EXT_MATCHCID_ON && tmp->matchcid == AST_EXT_MATCHCID_OFF)
            res = -1;
         else
            res = ext_cmp(e->cidmatch, tmp->cidmatch);
      }
      if (res >= 0)
         break;
   }
   if (e && res == 0) { /* exact match, insert in the priority chain */
      res = add_priority(con, tmp, el, e, replace);
      if (lock_context) {
         ast_unlock_context(con);
      }
      if (res < 0) {
         errno = EEXIST;   /* XXX do we care ? */
         return 0; /* XXX should we return -1 maybe ? */
      }
   } else {
      /*
       * not an exact match, this is the first entry with this pattern,
       * so insert in the main list right before 'e' (if any)
       */
      tmp->next = e;
      if (el) {  /* there is another exten already in this context */
         el->next = tmp;
         tmp->peer_table = ast_hashtab_create(13,
                     hashtab_compare_exten_numbers,
                     ast_hashtab_resize_java,
                     ast_hashtab_newsize_java,
                     hashtab_hash_priority,
                     0);
         tmp->peer_label_table = ast_hashtab_create(7,
                        hashtab_compare_exten_labels,
                        ast_hashtab_resize_java,
                        ast_hashtab_newsize_java,
                        hashtab_hash_labels,
                        0);
         if (label) {
            ast_hashtab_insert_safe(tmp->peer_label_table, tmp);
         }
         ast_hashtab_insert_safe(tmp->peer_table, tmp);
      } else {  /* this is the first exten in this context */
         if (!con->root_table)
            con->root_table = ast_hashtab_create(27,
                                       hashtab_compare_extens,
                                       ast_hashtab_resize_java,
                                       ast_hashtab_newsize_java,
                                       hashtab_hash_extens,
                                       0);
         con->root = tmp;
         con->root->peer_table = ast_hashtab_create(13,
                        hashtab_compare_exten_numbers,
                        ast_hashtab_resize_java,
                        ast_hashtab_newsize_java,
                        hashtab_hash_priority,
                        0);
         con->root->peer_label_table = ast_hashtab_create(7,
                           hashtab_compare_exten_labels,
                           ast_hashtab_resize_java,
                           ast_hashtab_newsize_java,
                           hashtab_hash_labels,
                           0);
         if (label) {
            ast_hashtab_insert_safe(con->root->peer_label_table, tmp);
         }
         ast_hashtab_insert_safe(con->root->peer_table, tmp);

      }
      ast_hashtab_insert_safe(con->root_table, tmp);
      if (lock_context) {
         ast_unlock_context(con);
      }
      if (tmp->priority == PRIORITY_HINT) {
         ast_add_hint(tmp);
      }
   }
   if (option_debug) {
      if (tmp->matchcid == AST_EXT_MATCHCID_ON) {
         ast_debug(1, "Added extension '%s' priority %d (CID match '%s') to %s (%p)\n",
                 tmp->exten, tmp->priority, tmp->cidmatch, con->name, con);
      } else {
         ast_debug(1, "Added extension '%s' priority %d to %s (%p)\n",
                 tmp->exten, tmp->priority, con->name, con);
      }
   }

   if (tmp->matchcid == AST_EXT_MATCHCID_ON) {
      ast_verb(3, "Added extension '%s' priority %d (CID match '%s') to %s\n",
             tmp->exten, tmp->priority, tmp->cidmatch, con->name);
   } else {
      ast_verb(3, "Added extension '%s' priority %d to %s\n",
             tmp->exten, tmp->priority, con->name);
   }

   return 0;
}

static int ast_add_extension_nolock	(	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
	)		[static]

Definition at line 9643 of file pbx.c.

References ast_add_extension2_lockopt(), and find_context().

Referenced by ast_merge_contexts_and_delete().

{
   int ret = -1;
   struct ast_context *c;

   c = find_context(context);
   if (c) {
      ret = ast_add_extension2_lockopt(c, replace, extension, priority, label, callerid,
         application, data, datad, registrar, 1);
   }

   return ret;
}

static int ast_add_hint

(

struct ast_exten *

e

)

[static]

Add hint to hint list, check initial extension state.

Definition at line 5857 of file pbx.c.

References add_hintdevice(), ao2_alloc, ao2_container_alloc, ao2_find, ao2_link, ao2_lock, ao2_ref, ao2_unlock, ast_debug, ast_extension_state2(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), ast_log(), ast_hint::callbacks, destroy_hint(), ast_hint::exten, extension_presence_state_helper(), hint_id_cmp(), ast_hint::last_presence_message, ast_hint::last_presence_state, ast_hint::last_presence_subtype, ast_hint::laststate, and LOG_WARNING.

Referenced by add_priority(), and ast_add_extension2_lockopt().

{
   struct ast_hint *hint_new;
   struct ast_hint *hint_found;
   char *message = NULL;
   char *subtype = NULL;
   int presence_state;

   if (!e) {
      return -1;
   }

   /*
    * We must create the hint we wish to add before determining if
    * it is already in the hints container to avoid possible
    * deadlock when getting the current extension state.
    */
   hint_new = ao2_alloc(sizeof(*hint_new), destroy_hint);
   if (!hint_new) {
      return -1;
   }

   /* Initialize new hint. */
   hint_new->callbacks = ao2_container_alloc(1, NULL, hint_id_cmp);
   if (!hint_new->callbacks) {
      ao2_ref(hint_new, -1);
      return -1;
   }
   hint_new->exten = e;
   hint_new->laststate = ast_extension_state2(e, NULL);
   if ((presence_state = extension_presence_state_helper(e, &subtype, &message)) > 0) {
      hint_new->last_presence_state = presence_state;
      hint_new->last_presence_subtype = subtype;
      hint_new->last_presence_message = message;
      message = subtype = NULL;
   }

   /* Prevent multiple add hints from adding the same hint at the same time. */
   ao2_lock(hints);

   /* Search if hint exists, do nothing */
   hint_found = ao2_find(hints, e, 0);
   if (hint_found) {
      ao2_ref(hint_found, -1);
      ao2_unlock(hints);
      ao2_ref(hint_new, -1);
      ast_debug(2, "HINTS: Not re-adding existing hint %s: %s\n",
         ast_get_extension_name(e), ast_get_extension_app(e));
      return -1;
   }

   /* Add new hint to the hints container */
   ast_debug(2, "HINTS: Adding hint %s: %s\n",
      ast_get_extension_name(e), ast_get_extension_app(e));
   ao2_link(hints, hint_new);
   if (add_hintdevice(hint_new, ast_get_extension_app(e))) {
      ast_log(LOG_WARNING, "Could not add devices for hint: %s@%s.\n",
         ast_get_extension_name(e),
         ast_get_context_name(ast_get_extension_context(e)));
   }

   ao2_unlock(hints);
   ao2_ref(hint_new, -1);

   return 0;
}

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:

Do _NOT_ hold any channel locks when calling this function.

Definition at line 9704 of file pbx.c.

References accountcode, amaflags, ast_cdr_discard(), ast_cdr_dup(), ast_channel_accountcode(), ast_channel_alloc(), ast_channel_amaflags(), ast_channel_cdr(), ast_channel_cdr_set(), ast_channel_context(), ast_channel_exten(), ast_channel_linkedid(), ast_channel_lock, ast_channel_masquerade(), ast_channel_name(), ast_channel_pbx(), ast_channel_readformat(), ast_channel_unlock, ast_channel_writeformat(), ast_do_masquerade(), ast_explicit_goto(), ast_format_copy(), ast_hangup(), ast_log(), ast_pbx_start(), AST_SOFTHANGUP_ASYNCGOTO, ast_softhangup_nolock(), ast_channel::cdr, context, exten, LOG_WARNING, ast_sw::name, S_OR, and state.

Referenced by __ast_goto_if_exists(), action_redirect(), ast_async_goto_by_name(), builtin_blindtransfer(), console_transfer(), dahdi_handle_dtmf(), fax_detect_framehook(), handle_request_bye(), handle_request_refer(), my_handle_dtmf(), pbx_parseable_goto(), process_ast_dsp(), process_sdp(), sip_read(), and socket_process_helper().

{
   int res = 0;
   struct ast_channel *tmpchan;
   struct {
      char *accountcode;
      char *exten;
      char *context;
      char *linkedid;
      char *name;
      struct ast_cdr *cdr;
      int amaflags;
      int state;
      struct ast_format readformat;
      struct ast_format writeformat;
   } tmpvars = { 0, };

   ast_channel_lock(chan);
   if (ast_channel_pbx(chan)) { /* This channel is currently in the PBX */
      ast_explicit_goto(chan, context, exten, priority + 1);
      ast_softhangup_nolock(chan, AST_SOFTHANGUP_ASYNCGOTO);
      ast_channel_unlock(chan);
      return res;
   }

   /* In order to do it when the channel doesn't really exist within
    * the PBX, we have to make a new channel, masquerade, and start the PBX
    * at the new location */
   tmpvars.accountcode = ast_strdupa(ast_channel_accountcode(chan));
   tmpvars.exten = ast_strdupa(ast_channel_exten(chan));
   tmpvars.context = ast_strdupa(ast_channel_context(chan));
   tmpvars.linkedid = ast_strdupa(ast_channel_linkedid(chan));
   tmpvars.name = ast_strdupa(ast_channel_name(chan));
   tmpvars.amaflags = ast_channel_amaflags(chan);
   tmpvars.state = ast_channel_state(chan);
   ast_format_copy(&tmpvars.writeformat, ast_channel_writeformat(chan));
   ast_format_copy(&tmpvars.readformat, ast_channel_readformat(chan));
   tmpvars.cdr = ast_channel_cdr(chan) ? ast_cdr_dup(ast_channel_cdr(chan)) : NULL;

   ast_channel_unlock(chan);

   /* Do not hold any channel locks while calling channel_alloc() since the function
    * locks the channel container when linking the new channel in. */
   if (!(tmpchan = ast_channel_alloc(0, tmpvars.state, 0, 0, tmpvars.accountcode, tmpvars.exten, tmpvars.context, tmpvars.linkedid, tmpvars.amaflags, "AsyncGoto/%s", tmpvars.name))) {
      ast_cdr_discard(tmpvars.cdr);
      return -1;
   }

   /* copy the cdr info over */
   if (tmpvars.cdr) {
      ast_cdr_discard(ast_channel_cdr(tmpchan));
      ast_channel_cdr_set(tmpchan, tmpvars.cdr);
      tmpvars.cdr = NULL;
   }

   /* Make formats okay */
   ast_format_copy(ast_channel_readformat(tmpchan), &tmpvars.readformat);
   ast_format_copy(ast_channel_writeformat(tmpchan), &tmpvars.writeformat);

   /* Setup proper location. Never hold another channel lock while calling this function. */
   ast_explicit_goto(tmpchan, S_OR(context, tmpvars.context), S_OR(exten, tmpvars.exten), priority);

   /* Masquerade into tmp channel */
   if (ast_channel_masquerade(tmpchan, chan)) {
      /* Failed to set up the masquerade.  It's probably chan_local
       * in the middle of optimizing itself out.  Sad. :( */
      ast_hangup(tmpchan);
      tmpchan = NULL;
      res = -1;
   } else {
      ast_do_masquerade(tmpchan);
      /* Start the PBX going on our stolen channel */
      if (ast_pbx_start(tmpchan)) {
         ast_log(LOG_WARNING, "Unable to start PBX on %s\n", ast_channel_name(tmpchan));
         ast_hangup(tmpchan);
         res = -1;
      }
   }

   return res;
}

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

Set the channel to next execute the specified dialplan location.

Definition at line 9786 of file pbx.c.

References ast_async_goto(), ast_channel_get_by_name(), and ast_channel_unref.

{
   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;
}

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 12288 of file pbx.c.

References __ast_goto_if_exists().

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

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 12353 of file pbx.c.

References pbx_parseable_goto().

Referenced by asyncgoto_exec(), and handle_redirect().

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

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

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

Parameters:

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

Return values:

Returns

1 on success or 0 on failure.

Definition at line 9286 of file pbx.c.

References ast_strdup, ast_strlen_zero(), ast_timing::daymask, days, ast_timing::dowmask, get_range(), get_timerange(), ast_timing::monthmask, months, and ast_timing::timezone.

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

{
   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] == ',') {
         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;
}

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 serach 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 6019 of file pbx.c.

References E_CANMATCH, and pbx_extension_helper().

Referenced by __analog_ss_thread(), analog_ss_thread(), background_detect_exec(), cb_events(), do_immediate_setup(), dp_lookup(), dundi_lookup_local(), get_also_info(), get_destination(), leave_voicemail(), loopback_canmatch(), mgcp_ss(), pbx_builtin_background(), phone_check_exception(), pri_dchannel(), and valid_exit().

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

static int ast_change_hint	(	struct ast_exten *	oe,
		struct ast_exten *	ne
	)		[static]

Change hint for an extension.

Definition at line 5925 of file pbx.c.

References add_hintdevice(), ao2_find, ao2_link, ao2_lock, ao2_ref, ao2_unlock, ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), ast_log(), ast_hint::exten, LOG_WARNING, OBJ_UNLINK, and remove_hintdevice().

Referenced by add_priority().

{
   struct ast_hint *hint;

   if (!oe || !ne) {
      return -1;
   }

   ao2_lock(hints);/* Locked to hold off others while we move the hint around. */

   /*
    * Unlink the hint from the hints container as the extension
    * name (which is the hash value) could change.
    */
   hint = ao2_find(hints, oe, OBJ_UNLINK);
   if (!hint) {
      ao2_unlock(hints);
      return -1;
   }

   remove_hintdevice(hint);

   /* Update the hint and put it back in the hints container. */
   ao2_lock(hint);
   hint->exten = ne;
   ao2_unlock(hint);
   ao2_link(hints, hint);
   if (add_hintdevice(hint, ast_get_extension_app(ne))) {
      ast_log(LOG_WARNING, "Could not add devices for hint: %s@%s.\n",
         ast_get_extension_name(ne),
         ast_get_context_name(ast_get_extension_context(ne)));
   }

   ao2_unlock(hints);
   ao2_ref(hint, -1);

   return 0;
}

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:

Returns

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

Definition at line 9329 of file pbx.c.

References ast_check_timing2(), and ast_tvnow().

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

{
   return ast_check_timing2(i, ast_tvnow());
}

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:

Returns

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

Definition at line 9334 of file pbx.c.

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().

{
   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;
}

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 12358 of file pbx.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, and ast_strdup.

Referenced by handle_orig(), and handle_show_application().

{
   struct ast_app *app = NULL;
   int which = 0;
   char *ret = NULL;
   size_t wordlen = strlen(word);

   AST_RWLIST_RDLOCK(&apps);
   AST_RWLIST_TRAVERSE(&apps, app, list) {
      if (!strncasecmp(word, app->name, wordlen) && ++which > state) {
         ret = ast_strdup(app->name);
         break;
      }
   }
   AST_RWLIST_UNLOCK(&apps);

   return ret;
}

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

Add an ignorepat.

Parameters:

context	which context to add the ignorpattern 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 9570 of file pbx.c.

References ast_context_add_ignorepat2(), ast_unlock_contexts(), and find_context_locked().

Referenced by handle_cli_dialplan_add_ignorepat().

{
   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;
}

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

Definition at line 9583 of file pbx.c.

References ast_calloc, ast_free, ast_unlock_context(), ast_wrlock_context(), errno, ast_context::ignorepats, ast_ignorepat::next, ast_ignorepat::pattern, ast_sw::registrar, and ast_ignorepat::registrar.

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

{
   struct ast_ignorepat *ignorepat, *ignorepatc, *ignorepatl = NULL;
   int length;
   char *pattern;
   length = sizeof(struct ast_ignorepat);
   length += strlen(value) + 1;
   if (!(ignorepat = ast_calloc(1, length)))
      return -1;
   /* The cast to char * is because we need to write the initial value.
    * The field is not supposed to be modified otherwise.  Also, gcc 4.2
    * sees the cast as dereferencing a type-punned pointer and warns about
    * it.  This is the workaround (we're telling gcc, yes, that's really
    * what we wanted to do).
    */
   pattern = (char *) ignorepat->pattern;
   strcpy(pattern, value);
   ignorepat->next = NULL;
   ignorepat->registrar = registrar;
   ast_wrlock_context(con);
   for (ignorepatc = con->ignorepats; ignorepatc; ignorepatc = ignorepatc->next) {
      ignorepatl = ignorepatc;
      if (!strcasecmp(ignorepatc->pattern, value)) {
         /* Already there */
         ast_unlock_context(con);
         ast_free(ignorepat);
         errno = EEXIST;
         return -1;
      }
   }
   if (ignorepatl)
      ignorepatl->next = ignorepat;
   else
      con->ignorepats = ignorepat;
   ast_unlock_context(con);
   return 0;

}

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 9114 of file pbx.c.

References ast_context_add_include2(), ast_unlock_contexts(), and find_context_locked().

Referenced by handle_cli_dialplan_add_include().

{
   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;
}

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

Add a context include.

Parameters:

con	context to add the include to
include	include to add
registrar	who registered the context

Adds an include taking a struct ast_context as the first parameter

Return values:

0	on success
-1	on failure

Definition at line 9383 of file pbx.c.

References ast_build_timing(), ast_calloc, ast_destroy_timing(), ast_free, ast_get_context_name(), ast_unlock_context(), ast_verb, ast_wrlock_context(), errno, ast_include::hastime, ast_context::includes, ast_include::name, ast_include::next, ast_include::registrar, ast_sw::registrar, ast_include::rname, ast_include::stuff, and ast_include::timing.

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

{
   struct ast_include *new_include;
   char *c;
   struct ast_include *i, *il = NULL; /* include, include_last */
   int length;
   char *p;

   length = sizeof(struct ast_include);
   length += 2 * (strlen(value) + 1);

   /* allocate new include structure ... */
   if (!(new_include = ast_calloc(1, length)))
      return -1;
   /* Fill in this structure. Use 'p' for assignments, as the fields
    * in the structure are 'const char *'
    */
   p = new_include->stuff;
   new_include->name = p;
   strcpy(p, value);
   p += strlen(value) + 1;
   new_include->rname = p;
   strcpy(p, value);
   /* Strip off timing info, and process if it is there */
   if ( (c = strchr(p, ',')) ) {
      *c++ = '\0';
      new_include->hastime = ast_build_timing(&(new_include->timing), c);
   }
   new_include->next      = NULL;
   new_include->registrar = registrar;

   ast_wrlock_context(con);

   /* ... go to last include and check if context is already included too... */
   for (i = con->includes; i; i = i->next) {
      if (!strcasecmp(i->name, new_include->name)) {
         ast_destroy_timing(&(new_include->timing));
         ast_free(new_include);
         ast_unlock_context(con);
         errno = EEXIST;
         return -1;
      }
      il = i;
   }

   /* ... include new context into context list, unlock, return */
   if (il)
      il->next = new_include;
   else
      con->includes = new_include;
   ast_verb(3, "Including context '%s' in context '%s'\n", new_include->name, ast_get_context_name(con));

   ast_unlock_context(con);

   return 0;
}

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 9446 of file pbx.c.

References ast_context_add_switch2(), ast_unlock_contexts(), and find_context_locked().

{
   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;
}

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 9466 of file pbx.c.

References ast_context::alts, ast_calloc, ast_free, ast_get_context_name(), AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_unlock_context(), ast_verb, ast_wrlock_context(), ast_sw::data, errno, ast_sw::eval, ast_sw::name, ast_sw::registrar, and ast_sw::stuff.

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

{
   struct ast_sw *new_sw;
   struct ast_sw *i;
   int length;
   char *p;

   length = sizeof(struct ast_sw);
   length += strlen(value) + 1;
   if (data)
      length += strlen(data);
   length++;

   /* allocate new sw structure ... */
   if (!(new_sw = ast_calloc(1, length)))
      return -1;
   /* ... fill in this structure ... */
   p = new_sw->stuff;
   new_sw->name = p;
   strcpy(new_sw->name, value);
   p += strlen(value) + 1;
   new_sw->data = p;
   if (data) {
      strcpy(new_sw->data, data);
      p += strlen(data) + 1;
   } else {
      strcpy(new_sw->data, "");
      p++;
   }
   new_sw->eval     = eval;
   new_sw->registrar = registrar;

   /* ... try to lock this context ... */
   ast_wrlock_context(con);

   /* ... go to last sw and check if context is already swd too... */
   AST_LIST_TRAVERSE(&con->alts, i, list) {
      if (!strcasecmp(i->name, new_sw->name) && !strcasecmp(i->data, new_sw->data)) {
         ast_free(new_sw);
         ast_unlock_context(con);
         errno = EEXIST;
         return -1;
      }
   }

   /* ... sw new context into context list, unlock, return */
   AST_LIST_INSERT_TAIL(&con->alts, new_sw, list);

   ast_verb(3, "Including switch '%s/%s' in context '%s'\n", new_sw->name, new_sw->data, ast_get_context_name(con));

   ast_unlock_context(con);

   return 0;
}

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.

Returns:

nothing

Definition at line 10925 of file pbx.c.

References __ast_context_destroy(), ast_unlock_contexts(), and ast_wrlock_contexts().

Referenced by __unload_module(), ast_features_reload(), cleanup_stale_contexts(), features_shutdown(), handle_cli_dialplan_remove_context(), remove_dead_dialplan_useage(), sla_destroy(), and unload_module().

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

struct ast_context* ast_context_find

(

const char *

name

)

[read]

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 3068 of file pbx.c.

References ast_copy_string(), ast_hashtab_lookup(), ast_rdlock_contexts(), ast_unlock_contexts(), ast_walk_contexts(), ast_context::name, and fake_context::name.

Referenced by __unload_module(), _macro_exec(), ast_context_verify_includes(), ast_features_reload(), ast_ignore_pattern(), cleanup_stale_contexts(), handle_cli_dialplan_add_extension(), handle_cli_dialplan_add_include(), handle_cli_dialplan_remove_context(), isexten_function_read(), manage_parkinglot(), parked_call_exec(), register_exten(), register_peer_exten(), remove_dead_dialplan_useage(), unload_module(), and unregister_exten().

{
   struct ast_context *tmp;
   struct fake_context item;

   if (!name) {
      return NULL;
   }
   ast_rdlock_contexts();
   if (contexts_table) {
      ast_copy_string(item.name, name, sizeof(item.name));
      tmp = ast_hashtab_lookup(contexts_table, &item);
   } else {
      tmp = NULL;
      while ((tmp = ast_walk_contexts(tmp))) {
         if (!strcasecmp(name, tmp->name)) {
            break;
         }
      }
   }
   ast_unlock_contexts();
   return tmp;
}

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

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 8678 of file pbx.c.

References ast_calloc, ast_copy_string(), 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_mutex_init, ast_rdlock_contexts(), ast_rwlock_init, ast_strdup, ast_unlock_contexts(), ast_verb, ast_wrlock_contexts(), contexts, ast_context::ignorepats, ast_context::includes, local_contexts, ast_context::lock, LOG_ERROR, ast_context::macrolock, ast_context::name, fake_context::name, ast_context::next, ast_context::refcount, ast_context::registrar, ast_context::root, and ast_context::root_table.

Referenced by ast_compile_ael2(), config_parse_variables(), context_merge(), handle_cli_dialplan_add_extension(), handle_cli_dialplan_add_include(), lua_register_hints(), lua_register_switches(), manage_parked_call(), parkinglot_activate(), pbx_load_config(), pbx_load_users(), reload_config(), set_config(), sla_build_station(), and sla_build_trunk().

{
   struct ast_context *tmp, **local_contexts;
   struct fake_context search;
   int length = sizeof(struct ast_context) + strlen(name) + 1;

   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();
   }

   ast_copy_string(search.name, name, sizeof(search.name));
   if (!extcontexts) {
      ast_rdlock_contexts();
      local_contexts = &contexts;
      tmp = ast_hashtab_lookup(contexts_table, &search);
      ast_unlock_contexts();
      if (tmp) {
         tmp->refcount++;
         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);
      ast_mutex_init(&tmp->macrolock);
      strcpy(tmp->name, name);
      tmp->root = NULL;
      tmp->root_table = NULL;
      tmp->registrar = ast_strdup(registrar);
      tmp->includes = NULL;
      tmp->ignorepats = NULL;
      tmp->refcount = 1;
   } else {
      ast_log(LOG_ERROR, "Danger! We failed to allocate a context for %s!\n", name);
      return NULL;
   }

   if (!extcontexts) {
      ast_wrlock_contexts();
      tmp->next = *local_contexts;
      *local_contexts = tmp;
      ast_hashtab_insert_safe(contexts_table, tmp); /*put this context into the tree */
      ast_unlock_contexts();
      ast_debug(1, "Registered context '%s'(%p) in table %p registrar: %s\n", tmp->name, tmp, contexts_table, registrar);
      ast_verb(3, "Registered extension context '%s'; registrar: %s\n", tmp->name, registrar);
   } 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 context '%s'(%p) in local table %p; registrar: %s\n", tmp->name, tmp, exttable, registrar);
      ast_verb(3, "Registered extension context '%s'; registrar: %s\n", tmp->name, registrar);
   }
   return tmp;
}

int ast_context_lockmacro

(

const char *

context

)

locks the macrolock in the given given context

Note:

This function locks contexts list by &conlist, searches for the right context structure, and locks the macrolock mutex in that context. macrolock is used to limit a macro to be executed by one call at a time.

Definition at line 7271 of file pbx.c.

References ast_mutex_lock, ast_unlock_contexts(), find_context_locked(), and ast_context::macrolock.

Referenced by _macro_exec().

{
   struct ast_context *c;
   int ret = -1;

   c = find_context_locked(context);
   if (c) {
      ast_unlock_contexts();

      /* if we found context, lock macrolock */
      ret = ast_mutex_lock(&c->macrolock);
   }

   return ret;
}

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

Simply remove extension from context.

Note:

This function will lock conlock.

Definition at line 7079 of file pbx.c.

References ast_context_remove_extension_callerid(), and AST_EXT_MATCHCID_ANY.

Referenced by register_peer_exten(), remove_exten_if_exist(), sla_station_destructor(), sla_trunk_destructor(), unregister_exten(), and unregister_extension().

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

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 7109 of file pbx.c.

References ast_context_remove_extension_callerid2(), and AST_EXT_MATCHCID_ANY.

Referenced by manage_parkinglot(), and parked_call_exec().

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

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

Definition at line 7084 of file pbx.c.

References ast_context_remove_extension_callerid2(), ast_unlock_contexts(), and find_context_locked().

Referenced by ast_context_remove_extension(), and handle_cli_dialplan_remove_extension().

{
   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;
}

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

Definition at line 7114 of file pbx.c.

References add_exten_to_pattern_tree(), ast_copy_string(), 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, match_char::deleted, destroy_exten(), exten, ast_exten::exten, match_char::exten, ast_exten::label, LOG_ERROR, LOG_NOTICE, LOG_WARNING, ast_exten::matchcid, ast_context::name, ast_exten::next, ast_context::pattern_tree, ast_exten::peer, ast_exten::peer_label_table, ast_exten::peer_table, ast_exten::priority, ast_exten::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().

{
   struct ast_exten *exten, *prev_exten = NULL;
   struct ast_exten *peer;
   struct ast_exten ex, *exten2, *exten3;
   char dummy_name[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;
   ex.matchcid = matchcallerid;
   ex.cidmatch = callerid;
   ast_copy_string(dummy_name, extension, sizeof(dummy_name));
   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->exten);
            }

            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->exten);
            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->exten, 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_log(LOG_ERROR,"Could not find priority %d of exten %s in context %s!\n",
                  priority, exten->exten, 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, extension) &&
         (!registrar || !strcmp(exten->registrar, registrar)) &&
         (!matchcallerid || (!ast_strlen_zero(callerid) && !ast_strlen_zero(exten->cidmatch) && !strcmp(exten->cidmatch, callerid)) || (ast_strlen_zero(callerid) && 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, extension) &&
         (!callerid || (!matchcallerid && !peer->matchcid) || (matchcallerid && peer->matchcid && !strcmp(peer->cidmatch, callerid))) ;
         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;
}

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

Definition at line 9526 of file pbx.c.

References ast_context_remove_ignorepat2(), ast_unlock_contexts(), and find_context_locked().

Referenced by handle_cli_dialplan_remove_ignorepat().

{
   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;
}

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

Definition at line 9539 of file pbx.c.

References ast_free, ast_unlock_context(), ast_wrlock_context(), errno, ast_context::ignorepats, ast_ignorepat::next, ast_ignorepat::pattern, and ast_ignorepat::registrar.

Referenced by ast_context_remove_ignorepat().

{
   struct ast_ignorepat *ip, *ipl = NULL;

   ast_wrlock_context(con);

   for (ip = con->ignorepats; ip; ip = ip->next) {
      if (!strcmp(ip->pattern, ignorepat) &&
         (!registrar || (registrar == ip->registrar))) {
         if (ipl) {
            ipl->next = ip->next;
            ast_free(ip);
         } else {
            con->ignorepats = ip->next;
            ast_free(ip);
         }
         ast_unlock_context(con);
         return 0;
      }
      ipl = ip;
   }

   ast_unlock_context(con);
   errno = EINVAL;
   return -1;
}

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

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

Remove a context include.

Definition at line 6972 of file pbx.c.

References ast_context_remove_include2(), ast_unlock_contexts(), and find_context_locked().

Referenced by handle_cli_dialplan_remove_include().

{
   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;
}

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

Locks context, remove included contexts, unlocks context. 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.

Removes an include by an ast_context structure.

Return values:

0	on success.
-1	on failure.

Definition at line 6995 of file pbx.c.

References ast_destroy_timing(), ast_free, ast_get_context_name(), ast_unlock_context(), ast_verb, ast_wrlock_context(), ast_context::includes, ast_include::name, ast_include::next, ast_include::registrar, and ast_include::timing.

Referenced by ast_context_remove_include().

{
   struct ast_include *i, *pi = NULL;
   int ret = -1;

   ast_wrlock_context(con);

   /* find our include */
   for (i = con->includes; i; pi = i, i = i->next) {
      if (!strcmp(i->name, include) &&
            (!registrar || !strcmp(i->registrar, 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);
         if (pi)
            pi->next = i->next;
         else
            con->includes = i->next;
         /* free include and return */
         ast_destroy_timing(&(i->timing));
         ast_free(i);
         ret = 0;
         break;
      }
   }

   ast_unlock_context(con);

   return ret;
}

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

Remove a switch.

Note:

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

Definition at line 7030 of file pbx.c.

References ast_context_remove_switch2(), ast_unlock_contexts(), and find_context_locked().

{
   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;
}

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 7052 of file pbx.c.

References ast_context::alts, ast_free, ast_get_context_name(), AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_unlock_context(), ast_verb, ast_wrlock_context(), ast_sw::data, ast_sw::name, and ast_sw::registrar.

Referenced by ast_context_remove_switch().

{
   struct ast_sw *i;
   int ret = -1;

   ast_wrlock_context(con);

   /* walk switches */
   AST_LIST_TRAVERSE_SAFE_BEGIN(&con->alts, i, list) {
      if (!strcmp(i->name, sw) && !strcmp(i->data, data) &&
         (!registrar || !strcmp(i->registrar, 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_LIST_REMOVE_CURRENT(list);
         ast_free(i); /* free switch and return */
         ret = 0;
         break;
      }
   }
   AST_LIST_TRAVERSE_SAFE_END;

   ast_unlock_context(con);

   return ret;
}

int ast_context_unlockmacro

(

const char *

context

)

Unlocks the macrolock in the given context.

Note:

This function locks contexts list by &conlist, searches for the right context structure, and unlocks the macrolock mutex in that context. macrolock is used to limit a macro to be executed by one call at a time.

Definition at line 7292 of file pbx.c.

References ast_mutex_unlock, ast_unlock_contexts(), find_context_locked(), and ast_context::macrolock.

Referenced by _macro_exec().

{
   struct ast_context *c;
   int ret = -1;

   c = find_context_locked(context);
   if (c) {
      ast_unlock_contexts();

      /* if we found context, unlock macrolock */
      ret = ast_mutex_unlock(&c->macrolock);
   }

   return ret;
}

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 12243 of file pbx.c.

References ast_context_find(), ast_get_context_name(), ast_log(), ast_walk_context_includes(), LOG_WARNING, and ast_include::rname.

Referenced by pbx_load_module().

{
   struct ast_include *inc = NULL;
   int res = 0;

   while ( (inc = ast_walk_context_includes(con, inc)) ) {
      if (ast_context_find(inc->rname))
         continue;

      res = -1;
      ast_log(LOG_WARNING, "Context '%s' tries to include nonexistent context '%s'\n",
         ast_get_context_name(con), inc->rname);
      break;
   }

   return res;
}

struct ast_custom_function* ast_custom_function_find

(

const char *

name

)

[read]

Definition at line 3917 of file pbx.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, and ast_custom_function::name.

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

{
   struct ast_custom_function *acf = NULL;

   AST_RWLIST_RDLOCK(&acf_root);
   AST_RWLIST_TRAVERSE(&acf_root, acf, acflist) {
      if (!strcmp(name, acf->name))
         break;
   }
   AST_RWLIST_UNLOCK(&acf_root);

   return acf;
}

int ast_custom_function_unregister

(

struct ast_custom_function *

acf

)

Unregister a custom function.

Definition at line 3931 of file pbx.c.

References ast_free, AST_RWLIST_REMOVE, AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, 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 __ast_custom_function_register_escalating(), _unload_module(), features_shutdown(), load_module(), manager_shutdown(), message_shutdown(), reload(), unload_module(), and unload_pbx().

{
   struct ast_custom_function *cur;
   struct ast_custom_escalating_function *cur_escalation;

   if (!acf) {
      return -1;
   }

   AST_RWLIST_WRLOCK(&acf_root);
   if ((cur = AST_RWLIST_REMOVE(&acf_root, acf, acflist))) {
#ifdef AST_XML_DOCS
      if (cur->docsrc == AST_XML_DOC) {
         ast_string_field_free_memory(acf);
      }
#endif
      ast_verb(2, "Unregistered custom function %s\n", cur->name);
   }
   AST_RWLIST_UNLOCK(&acf_root);

   /* Remove from the escalation list */
   AST_RWLIST_WRLOCK(&escalation_root);
   AST_RWLIST_TRAVERSE_SAFE_BEGIN(&escalation_root, cur_escalation, list) {
      if (cur_escalation->acf == acf) {
         AST_RWLIST_REMOVE_CURRENT(list);
         ast_free(cur_escalation);
         break;
      }
   }
   AST_RWLIST_TRAVERSE_SAFE_END;
   AST_RWLIST_UNLOCK(&escalation_root);

   return cur ? 0 : -1;
}

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 9368 of file pbx.c.

References ast_free, and ast_timing::timezone.

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

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

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 4974 of file pbx.c.

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().

{
   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;
}

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 6004 of file pbx.c.

References E_MATCH, and pbx_extension_helper().

Referenced by __analog_ss_thread(), __ast_goto_if_exists(), __ast_pbx_run(), _macro_exec(), acf_isexten_exec(), action_originate(), analog_ss_thread(), answer_call(), ast_app_dtget(), ast_bridge_call(), ast_pbx_outgoing_exten(), cb_events(), cli_console_dial(), conf_run(), console_dial(), console_transfer(), dahdi_handle_dtmf(), dahdi_r2_on_call_offered(), dahdi_r2_on_dnis_digit_received(), dial_exec_full(), disa_exec(), dp_lookup(), dundi_lookup_local(), fax_detect_framehook(), findmeexec(), get_also_info(), get_destination(), get_refer_info(), gosub_exec(), handle_gosub(), isexten_function_read(), jingle_new(), key_dial_page(), leave_voicemail(), local_alloc(), local_call(), local_devicestate(), loopback_exists(), manage_parked_call(), metermaidstate(), mgcp_ss(), minivm_greet_exec(), misdn_overlap_dial_task(), my_handle_dtmf(), parkandannounce_exec(), pbx_builtin_waitexten(), phone_check_exception(), pri_dchannel(), pri_ss_thread(), privacy_exec(), process_ast_dsp(), process_sdp(), readexten_exec(), register_peer_exten(), setsubstate(), show_debug_helper(), sip_new(), sip_read(), skinny_dialer(), socket_process_helper(), ss7_linkset(), try_calling(), vm_authenticate(), and waitstream_core().

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

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.

Definition at line 9680 of file pbx.c.

References ast_channel_context_set(), ast_channel_exten_set(), ast_channel_flags(), ast_channel_lock, ast_channel_priority_set(), ast_channel_unlock, AST_FLAG_IN_AUTOLOOP, ast_strlen_zero(), and ast_test_flag.

Referenced by __ast_goto_if_exists(), ast_async_goto(), builtin_atxfer(), disa_exec(), do_bridge_masquerade(), handle_setpriority(), msg_route(), and pbx_parseable_goto().

{
   if (!chan)
      return -1;

   ast_channel_lock(chan);

   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;
}

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

Definition at line 3045 of file pbx.c.

References ast_log(), E_CANMATCH, E_MATCHMORE, extension_match_core(), and LOG_WARNING.

Referenced by lua_find_extension(), and realtime_switch_common().

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

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 2810 of file pbx.c.

References ext_cmp().

Referenced by lua_extension_cmp().

{
   int cmp;

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

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 3040 of file pbx.c.

References 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(), misdn_cfg_is_msn_valid(), realtime_switch_common(), reload(), show_dialplan_helper(), and sig_pri_msn_match().

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

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

Check extension state for an extension by using hint.

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

Definition at line 5130 of file pbx.c.

References internal_extension_state_extended().

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

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

static int ast_extension_state2	(	struct ast_exten *	e,
		struct ao2_container *	device_state_info
	)		[static]

Check state of extension by using hints.

Definition at line 5081 of file pbx.c.

References ast_extension_state3(), ast_get_extension_app(), ast_str_set(), ast_str_thread_get(), and extensionstate_buf.

Referenced by ast_add_hint(), and internal_extension_state_extended().

{
   struct ast_str *hint_app = ast_str_thread_get(&extensionstate_buf, 32);

   if (!e || !hint_app) {
      return -1;
   }

   ast_str_set(&hint_app, 0, "%s", ast_get_extension_app(e));
   return ast_extension_state3(hint_app, device_state_info);
}

const char* ast_extension_state2str

(

int

extension_state

)

Return extension_state as string.

Return string representation of the state of an extension.

Definition at line 5094 of file pbx.c.

References ARRAY_LEN, extension_states, and cfextension_states::text.

Referenced by extensionstate_update(), handle_request_subscribe(), handle_show_hint(), handle_show_hints(), hints_data_provider_get(), show_channels_cb(), and skinny_extensionstate_cb().

{
   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";
}

static int ast_extension_state3	(	struct ast_str *	hint_app,
		struct ao2_container *	device_state_info
	)		[static]

Definition at line 5049 of file pbx.c.

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_alloc_options, ao2_link, ao2_ref, ast_devstate_aggregate_add(), ast_devstate_aggregate_init(), ast_devstate_aggregate_result(), ast_devstate_to_extenstate(), ast_device_state_info::device_name, ast_device_state_info::device_state, device_state_info_dt(), parse_hint_device(), and state.

Referenced by ast_extension_state2(), and handle_statechange().

{
   char *cur;
   char *rest;
   struct ast_devstate_aggregate agg;

   /* One or more devices separated with a & character */
   rest = parse_hint_device(hint_app);

   ast_devstate_aggregate_init(&agg);
   while ((cur = strsep(&rest, "&"))) {
      enum ast_device_state state = ast_device_state(cur);

      ast_devstate_aggregate_add(&agg, state);
      if (device_state_info) {
         struct ast_device_state_info *obj;

         obj = ao2_alloc_options(sizeof(*obj) + strlen(cur), device_state_info_dt, AO2_ALLOC_OPT_LOCK_NOLOCK);
         /* if failed we cannot add this device */
         if (obj) {
            obj->device_state = state;
            strcpy(obj->device_name, cur);
            ao2_link(device_state_info, obj);
            ao2_ref(obj, -1);
         }
      }
   }

   return ast_devstate_to_extenstate(ast_devstate_aggregate_result(&agg));
}

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

Add watcher for extension states.

Registers a state change callback.

Definition at line 5700 of file pbx.c.

References extension_state_add_destroy().

Referenced by __init_manager(), load_module(), and skinny_register().

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

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.

Registers a state change callback with destructor.

Definition at line 5693 of file pbx.c.

References extension_state_add_destroy().

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

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.

Registers an extended state change callback with destructor.

Definition at line 5707 of file pbx.c.

References extension_state_add_destroy().

Referenced by handle_request_subscribe().

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

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.

Registers an extended state change callback.

Definition at line 5714 of file pbx.c.

References extension_state_add_destroy().

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

int ast_extension_state_del	(	int	id,
		ast_state_cb_type	change_cb
	)

ast_extension_state_del: Remove a watcher from the callback list

Deletes a registered state change callback by ID.

Definition at line 5736 of file pbx.c.

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

Referenced by dialog_unlink_all(), handle_request_subscribe(), skinny_unregister(), and unload_module().

{
   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;
}

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

Check extended extension state for an extension by using hint.

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

Definition at line 5136 of file pbx.c.

References alloc_device_state_info(), ao2_ref, container, get_device_state_causing_channels(), and internal_extension_state_extended().

Referenced by handle_request_subscribe().

{
   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;
}

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 6009 of file pbx.c.

References E_FINDLABEL, and pbx_extension_helper().

Referenced by action_originate(), action_redirect(), handle_gosub(), handle_setpriority(), isexten_function_read(), and pbx_parseable_goto().

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

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 6014 of file pbx.c.

References E_FINDLABEL, and pbx_extension_helper().

Referenced by pbx_load_config().

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

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 4294 of file pbx.c.

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(), copy(), func_args(), is_read_allowed(), LOG_ERROR, ast_custom_function::mod, ast_custom_function::read, ast_custom_function::read2, and str.

Referenced by action_getvar(), action_status(), handle_getvariable(), lua_get_variable_value(), and pbx_substitute_variables_helper_full().

{
   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;
}

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 4333 of file pbx.c.

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(), copy(), func_args(), is_read_allowed(), LOG_ERROR, maxsize, ast_custom_function::mod, ast_custom_function::read, ast_custom_function::read2, ast_custom_function::read_max, and VAR_BUF_SIZE.

Referenced by append_channel_vars(), and ast_str_substitute_variables_full().

{
   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);
      }
      if (acfptr->mod && u) {
         __ast_module_user_remove(acfptr->mod, u);
      }
      return res;
   }
   return -1;
}

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 4380 of file pbx.c.

References __ast_module_user_add(), __ast_module_user_remove(), args, ast_custom_function_find(), ast_log(), copy(), func_args(), is_write_allowed(), LOG_ERROR, ast_custom_function::mod, and ast_custom_function::write.

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

{
   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;
}

const char* ast_get_context_name

(

struct ast_context *

con

)

Definition at line 12095 of file pbx.c.

References ast_context::name.

Referenced by _macro_exec(), 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_merge_incls_swits_igps_other_registrars(), destroy_hint(), dundi_precache_full(), find_matching_endwhile(), find_matching_priority(), handle_cli_dialplan_save(), handle_presencechange(), handle_show_hint(), handle_show_hints(), handle_statechange(), hints_data_provider_get(), manager_show_dialplan_helper(), show_debug_helper(), and show_dialplan_helper().

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

const char* ast_get_context_registrar

(

struct ast_context *

c

)

Definition at line 12133 of file pbx.c.

References ast_context::registrar.

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

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

const char* ast_get_extension_app

(

struct ast_exten *

e

)

Definition at line 12163 of file pbx.c.

References ast_exten::app.

Referenced by _macro_exec(), ast_add_hint(), ast_change_hint(), ast_extension_state2(), ast_get_hint(), ast_str_get_hint(), extension_presence_state_helper(), find_matching_endwhile(), get_parking_exten(), handle_cli_dialplan_save(), handle_presencechange(), handle_show_hint(), handle_show_hints(), handle_statechange(), hints_data_provider_get(), manager_show_dialplan_helper(), and print_ext().

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

void* ast_get_extension_app_data

(

struct ast_exten *

e

)

Definition at line 12168 of file pbx.c.

References ast_exten::data.

Referenced by _macro_exec(), ast_get_hint(), ast_masq_park_call_exten(), ast_park_call_exten(), ast_str_get_hint(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), print_ext(), and xfer_park_call_helper().

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

const char* ast_get_extension_cidmatch

(

struct ast_exten *

e

)

Definition at line 12158 of file pbx.c.

References ast_exten::cidmatch.

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

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

struct ast_context* ast_get_extension_context

(

struct ast_exten *

exten

)

[read]

Definition at line 12100 of file pbx.c.

References ast_exten::parent.

Referenced by ast_add_hint(), ast_change_hint(), ast_remove_hint(), destroy_hint(), handle_presencechange(), handle_show_hint(), handle_show_hints(), handle_statechange(), and hints_data_provider_get().

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

const char* ast_get_extension_label

(

struct ast_exten *

exten

)

Definition at line 12110 of file pbx.c.

References ast_exten::label.

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

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

int ast_get_extension_matchcid

(

struct ast_exten *

e

)

Definition at line 12153 of file pbx.c.

References ast_exten::matchcid.

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

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

const char* ast_get_extension_name

(

struct ast_exten *

exten

)

Definition at line 12105 of file pbx.c.

References ast_exten::exten.

Referenced by ast_add_hint(), ast_change_hint(), ast_remove_hint(), complete_core_show_hint(), complete_dialplan_remove_extension(), destroy_hint(), dundi_precache_full(), find_matching_priority(), handle_cli_dialplan_save(), handle_presencechange(), handle_show_hint(), handle_show_hints(), handle_statechange(), hint_hash(), hints_data_provider_get(), manager_show_dialplan_helper(), and show_dialplan_helper().

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

int ast_get_extension_priority

(

struct ast_exten *

exten

)

Definition at line 12125 of file pbx.c.

References ast_exten::priority.

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

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

const char* ast_get_extension_registrar

(

struct ast_exten *

e

)

Definition at line 12138 of file pbx.c.

References ast_exten::registrar.

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

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

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

Get hint for channel.

If an extension hint exists, return non-zero.

Definition at line 5966 of file pbx.c.

References ast_copy_string(), ast_get_extension_app(), ast_get_extension_app_data(), and ast_hint_extension().

Referenced by action_extensionstate(), get_cid_name(), get_destination(), hint_read(), manager_state_cb(), skinny_extensionstate_cb(), and state_notify_build_xml().

{
   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;
}

const char* ast_get_ignorepat_name

(

struct ast_ignorepat *

ip

)

Definition at line 12120 of file pbx.c.

References ast_ignorepat::pattern.

Referenced by 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().

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

const char* ast_get_ignorepat_registrar

(

struct ast_ignorepat *

ip

)

Definition at line 12148 of file pbx.c.

References ast_ignorepat::registrar.

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

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

const char* ast_get_include_name

(

struct ast_include *

inc

)

Definition at line 12115 of file pbx.c.

References ast_include::name.

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

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

const char* ast_get_include_registrar

(

struct ast_include *

i

)

Definition at line 12143 of file pbx.c.

References ast_include::registrar.

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

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

const char* ast_get_switch_data

(

struct ast_sw *

sw

)

Definition at line 12178 of file pbx.c.

References ast_sw::data.

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

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

int ast_get_switch_eval

(

struct ast_sw *

sw

)

Definition at line 12183 of file pbx.c.

References ast_sw::eval.

Referenced by context_merge_incls_swits_igps_other_registrars().

{
   return sw->eval;
}

const char* ast_get_switch_name

(

struct ast_sw *

sw

)

Definition at line 12173 of file pbx.c.

References ast_sw::name.

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

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

const char* ast_get_switch_registrar

(

struct ast_sw *

sw

)

Definition at line 12188 of file pbx.c.

References ast_sw::registrar.

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

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

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 12283 of file pbx.c.

References __ast_goto_if_exists().

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

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

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

hashtable functions for contexts

Definition at line 1233 of file pbx.c.

References ast_context::name.

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

{
   const struct ast_context *ac = ah_a;
   const struct ast_context *bc = ah_b;
   if (!ac || !bc) /* safety valve, but it might prevent a crash you'd rather have happen */
      return 1;
   /* assume context names are registered in a string table! */
   return strcmp(ac->name, bc->name);
}

unsigned int ast_hashtab_hash_contexts

(

const void *

obj

)

Definition at line 1285 of file pbx.c.

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().

{
   const struct ast_context *ac = obj;
   return ast_hashtab_hash_string(ac->name);
}

static struct ast_exten* ast_hint_extension	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten
	)		[static, read]

Definition at line 4965 of file pbx.c.

References ast_hint_extension_nolock(), ast_rdlock_contexts(), and ast_unlock_contexts().

Referenced by ast_get_hint(), ast_hint_presence_state(), ast_str_get_hint(), extension_state_add_destroy(), and internal_extension_state_extended().

{
   struct ast_exten *e;
   ast_rdlock_contexts();
   e = ast_hint_extension_nolock(c, context, exten);
   ast_unlock_contexts();
   return e;
}

static struct ast_exten* ast_hint_extension_nolock	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten
	)		[static, read]

Find hint for given extension in context.

Definition at line 4959 of file pbx.c.

References E_MATCH, pbx_find_extension(), PRIORITY_HINT, and pbx_find_info::stacklen.

Referenced by ast_hint_extension(), and ast_merge_contexts_and_delete().

{
   struct pbx_find_info q = { .stacklen = 0 }; /* the rest is set in pbx_find_context */
   return pbx_find_extension(c, NULL, &q, context, exten, PRIORITY_HINT, NULL, "", E_MATCH);
}

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 5186 of file pbx.c.

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

Referenced by handle_request_subscribe().

{
   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 */
      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);
      if (!(e = ast_hint_extension(c, context, exten))) {
         /* Improbable, but not impossible */
         return -1;
      }
   }

   return extension_presence_state_helper(e, subtype, message);
}

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 9622 of file pbx.c.

References ast_context_find(), ast_extension_match(), ast_context::ignorepats, ast_ignorepat::next, and ast_ignorepat::pattern.

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

{
   struct ast_context *con = ast_context_find(context);

   if (con) {
      struct ast_ignorepat *pat;

      for (pat = con->ignorepats; pat; pat = pat->next) {
         if (ast_extension_match(pat->pattern, pattern))
            return 1;
      }
   }

   return 0;
}

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 serach 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 6024 of file pbx.c.

References E_MATCHMORE, and pbx_extension_helper().

Referenced by __analog_ss_thread(), __ast_pbx_run(), analog_ss_thread(), ast_app_dtget(), collect_digits(), dahdi_r2_on_dnis_digit_received(), disa_exec(), dp_lookup(), dundi_lookup_local(), key_dial_page(), loopback_matchmore(), mgcp_ss(), pbx_builtin_background(), pri_dchannel(), pri_ss_thread(), readexten_exec(), and skinny_dialer().

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

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 8888 of file pbx.c.

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_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, contexts, contexts_table, ast_exten::data, ast_state_cb::data, store_hint::data, E_MATCH, execute_state_callback(), exten, 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_sw::next, ast_context::next, OBJ_UNLINK, ast_exten::parent, pbx_find_extension(), PRIORITY_HINT, ast_exten::registrar, and pbx_find_info::stacklen.

Referenced by lua_reload_extensions(), and pbx_load_module().

{
   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;
   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) {
      /* 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))) {
      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)) {
         ao2_lock(hint);
         if (!hint->exten) {
            /* The extension has already been destroyed. (Should never happen here) */
            ao2_unlock(hint);
            continue;
         }

         length = strlen(hint->exten->exten) + strlen(hint->exten->parent->name) + 2
            + 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;
         strcpy(saved_hint->exten, hint->exten->exten);
         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
          * encumberd 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);
      }
   }

   ao2_unlock(hints);
   ast_unlock_contexts();

   /*
    * Notify watchers of all removed hints with the same lock
    * environment as handle_statechange().
    */
   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(3,"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(3,"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(3,"Time to delete the old dialplan: %8.6f sec\n", ft);

   ft = ast_tvdiff_us(enddeltime, begintime);
   ft /= 1000000.0;
   ast_verb(3,"Total time merge_contexts_delete: %8.6f sec\n", ft);
}

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 12348 of file pbx.c.

References pbx_parseable_goto().

Referenced by _while_exec(), bridge_exec(), check_goto_on_transfer(), dial_exec_full(), gosub_exec(), ivr_dispatch(), parkandannounce_exec(), pbx_builtin_goto(), try_calling(), and while_continue_exec().

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

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.

Returns:

Nothing

Definition at line 6034 of file pbx.c.

References ast_cdr_end(), ast_channel_caller(), ast_channel_cdr(), 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_opt_end_cdr_before_h_exten, ast_set2_flag, ast_set_flag, AST_SOFTHANGUP_APPUNLOAD, ast_softhangup_nolock(), ast_spawn_extension(), ast_test_flag, ast_verb, and S_COR.

Referenced by __ast_pbx_run(), ast_bridge_call(), and dial_exec_full().

{
   int autoloopflag;
   int found;
   int spawn_error;

   ast_channel_lock(chan);

   if (ast_channel_cdr(chan) && ast_opt_end_cdr_before_h_exten) {
      ast_cdr_end(ast_channel_cdr(chan));
   }

   /* 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);

   /*
    * 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_APPUNLOAD);

   /* 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);
}

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.

Returns:

Nothing

Definition at line 6161 of file pbx.c.

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

Referenced by ast_channel_destructor(), and ast_dummy_channel_destructor().

{
   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);
}

static void ast_pbx_hangup_handler_headers

(

int

fd

)

[static]

Definition at line 6285 of file pbx.c.

References ast_cli(), and HANDLER_FORMAT.

Referenced by handle_show_hangup_all(), and handle_show_hangup_channel().

{
   ast_cli(fd, HANDLER_FORMAT, "Channel", "Handler");
}

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.

Returns:

Nothing

Definition at line 6153 of file pbx.c.

References ast_channel_hangup_handlers(), and AST_LIST_HEAD_INIT_NOLOCK.

Referenced by __ast_channel_alloc_ap(), and ast_dummy_channel_alloc().

{
   struct ast_hangup_handler_list *handlers;

   handlers = ast_channel_hangup_handlers(chan);
   AST_LIST_HEAD_INIT_NOLOCK(handlers);
}

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 6177 of file pbx.c.

References ast_hangup_handler::args, ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_name(), ast_channel_uniqueid(), ast_channel_unlock, ast_free, AST_LIST_REMOVE_HEAD, EVENT_FLAG_DIALPLAN, and manager_event.

Referenced by func_channel_write_real().

{
   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) {
      /*** DOCUMENTATION
         <managerEventInstance>
            <synopsis>
               Raised when a hangup handler is removed from the handler
               stack by the CHANNEL() function.
            </synopsis>
            <syntax>
               <parameter name="Handler">
                  <para>Hangup handler parameter string passed to the Gosub application.</para>
               </parameter>
            </syntax>
            <see-also>
               <ref type="managerEvent">HangupHandlerPush</ref>
               <ref type="function">CHANNEL</ref>
            </see-also>
         </managerEventInstance>
      ***/
      manager_event(EVENT_FLAG_DIALPLAN, "HangupHandlerPop",
         "Channel: %s\r\n"
         "Uniqueid: %s\r\n"
         "Handler: %s\r\n",
         ast_channel_name(chan),
         ast_channel_uniqueid(chan),
         h_handler->args);
   }
   ast_channel_unlock(chan);
   if (h_handler) {
      ast_free(h_handler);
      return 1;
   }
   return 0;
}

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.

Returns:

Nothing

Definition at line 6219 of file pbx.c.

References ast_hangup_handler::args, ast_app_expand_sub_args(), ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_name(), ast_channel_uniqueid(), ast_channel_unlock, ast_free, AST_LIST_INSERT_HEAD, ast_malloc, ast_strlen_zero(), EVENT_FLAG_DIALPLAN, and manager_event.

Referenced by func_channel_write_real().

{
   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);

   /*** DOCUMENTATION
      <managerEventInstance>
         <synopsis>
            Raised when a hangup handler is added to the handler
            stack by the CHANNEL() function.
         </synopsis>
         <syntax>
            <parameter name="Handler">
               <para>Hangup handler parameter string passed to the Gosub application.</para>
            </parameter>
         </syntax>
         <see-also>
            <ref type="managerEvent">HangupHandlerPop</ref>
            <ref type="function">CHANNEL</ref>
         </see-also>
      </managerEventInstance>
   ***/
   manager_event(EVENT_FLAG_DIALPLAN, "HangupHandlerPush",
      "Channel: %s\r\n"
      "Uniqueid: %s\r\n"
      "Handler: %s\r\n",
      ast_channel_name(chan),
      ast_channel_uniqueid(chan),
      h_handler->args);

   ast_channel_unlock(chan);
}

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 6096 of file pbx.c.

References ast_hangup_handler::args, ast_app_exec_sub(), ast_cdr_end(), ast_channel_cdr(), ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_name(), ast_channel_uniqueid(), ast_channel_unlock, ast_free, AST_LIST_EMPTY, AST_LIST_REMOVE_HEAD, ast_opt_end_cdr_before_h_exten, AST_SOFTHANGUP_APPUNLOAD, ast_softhangup_nolock(), EVENT_FLAG_DIALPLAN, and manager_event.

Referenced by __ast_pbx_run(), ast_bridge_call(), and ast_hangup().

{
   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;
   }

   if (ast_channel_cdr(chan) && ast_opt_end_cdr_before_h_exten) {
      ast_cdr_end(ast_channel_cdr(chan));
   }

   /*
    * 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_APPUNLOAD);

   for (;;) {
      handlers = ast_channel_hangup_handlers(chan);
      h_handler = AST_LIST_REMOVE_HEAD(handlers, node);
      if (!h_handler) {
         break;
      }

      /*** DOCUMENTATION
         <managerEventInstance>
            <synopsis>Raised when a hangup handler is about to be called.</synopsis>
            <syntax>
               <parameter name="Handler">
                  <para>Hangup handler parameter string passed to the Gosub application.</para>
               </parameter>
            </syntax>
         </managerEventInstance>
      ***/
      manager_event(EVENT_FLAG_DIALPLAN, "HangupHandlerRun",
         "Channel: %s\r\n"
         "Uniqueid: %s\r\n"
         "Handler: %s\r\n",
         ast_channel_name(chan),
         ast_channel_uniqueid(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;
}

static void ast_pbx_hangup_handler_show	(	int	fd,
		struct ast_channel *	chan
	)		[static]

Definition at line 6300 of file pbx.c.

References ast_hangup_handler::args, ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_name(), ast_channel_unlock, ast_cli(), AST_LIST_TRAVERSE, first, and HANDLER_FORMAT.

Referenced by handle_show_hangup_all(), and handle_show_hangup_channel().

{
   struct ast_hangup_handler_list *handlers;
   struct ast_hangup_handler *h_handler;
   int first = 1;

   ast_channel_lock(chan);
   handlers = ast_channel_hangup_handlers(chan);
   AST_LIST_TRAVERSE(handlers, h_handler, node) {
      ast_cli(fd, HANDLER_FORMAT, first ? ast_channel_name(chan) : "", h_handler->args);
      first = 0;
   }
   ast_channel_unlock(chan);
}

int ast_pbx_init

(

void

)

Provided by pbx.c

Definition at line 12437 of file pbx.c.

References ao2_container_alloc, ast_register_atexit(), HASH_EXTENHINT_SIZE, hint_cmp(), hint_hash(), hintdevice_cmp_multiple(), hintdevice_hash_cb(), pbx_shutdown(), and statecbs_cmp().

Referenced by main().

{
   hints = ao2_container_alloc(HASH_EXTENHINT_SIZE, hint_hash, hint_cmp);
   hintdevices = ao2_container_alloc(HASH_EXTENHINT_SIZE, hintdevice_hash_cb, hintdevice_cmp_multiple);
   statecbs = ao2_container_alloc(1, NULL, statecbs_cmp);

   ast_register_atexit(pbx_shutdown);

   return (hints && hintdevices && statecbs) ? 0 : -1;
}

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	sync,
		const char *	cid_num,
		const char *	cid_name,
		struct ast_variable *	vars,
		const char *	account,
		struct ast_channel **	locked_channel
	)

Synchronously or asynchronously make an outbound call and send it to a particular application with given extension

Definition at line 10565 of file pbx.c.

References __ast_request_and_dial(), outgoing_helper::account, async_stat::app, async_stat::appdata, ast_callid_threadstorage_auto(), ast_callid_threadstorage_auto_clean(), ast_callid_unref, ast_calloc, ast_cdr_disposition(), ast_cdr_failed(), ast_cdr_setaccount(), ast_channel_callid(), ast_channel_callid_set(), ast_channel_cdr(), ast_channel_hangupcause(), ast_channel_lock, ast_channel_name(), ast_channel_unlock, ast_copy_string(), ast_free, ast_hangup(), ast_log(), ast_pbx_outgoing_cdr_failed(), ast_pbx_run_app(), ast_pthread_create_detached, ast_set_variables(), AST_STATE_UP, ast_string_field_free_memory, ast_string_field_init, ast_string_field_set, ast_strlen_zero(), ast_variables_destroy(), ast_verb, async_wait(), async_stat::chan, app_tmp::chan, errno, LOG_WARNING, async_stat::p, app_tmp::t, async_stat::timeout, and outgoing_helper::vars.

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

{
   struct ast_channel *chan;
   struct app_tmp *tmp;
   struct ast_callid *callid;
   int callid_created;
   int res = -1, cdr_res = -1;
   struct outgoing_helper oh;

   /* Start by checking for a callid in threadstorage, and if none is found, bind one. */
   callid_created = ast_callid_threadstorage_auto(&callid);

   memset(&oh, 0, sizeof(oh));
   oh.vars = vars;
   oh.account = account;

   if (locked_channel)
      *locked_channel = NULL;
   if (ast_strlen_zero(app)) {
      res = -1;
      goto outgoing_app_cleanup;
   }
   if (synchronous) {
      chan = __ast_request_and_dial(type, cap, NULL, addr, timeout, reason, cid_num, cid_name, &oh);
      if (chan) {
         /* Bind the newly created callid to the channel if it doesn't already have one on creation */
         struct ast_callid *channel_callid = ast_channel_callid(chan);
         if (channel_callid) {
            ast_callid_unref(channel_callid);
         } else {
            if (callid) {
               ast_channel_callid_set(chan, callid);
            }
         }

         ast_set_variables(chan, vars);
         if (account)
            ast_cdr_setaccount(chan, account);
         if (ast_channel_state(chan) == AST_STATE_UP) {
            res = 0;
            ast_verb(4, "Channel %s was answered.\n", ast_channel_name(chan));
            tmp = ast_calloc(1, sizeof(*tmp));
            if (!tmp || ast_string_field_init(tmp, 252)) {
               if (tmp) {
                  ast_free(tmp);
               }
               res = -1;
            } else {
               ast_string_field_set(tmp, app, app);
               ast_string_field_set(tmp, data, appdata);
               tmp->chan = chan;
               if (synchronous > 1) {
                  if (locked_channel)
                     ast_channel_unlock(chan);
                  ast_pbx_run_app(tmp);
               } else {
                  if (locked_channel)
                     ast_channel_lock(chan);
                  if (ast_pthread_create_detached(&tmp->t, NULL, ast_pbx_run_app, tmp)) {
                     ast_log(LOG_WARNING, "Unable to spawn execute thread on %s: %s\n", ast_channel_name(chan), strerror(errno));
                     ast_string_field_free_memory(tmp);
                     ast_free(tmp);
                     if (locked_channel)
                        ast_channel_unlock(chan);
                     ast_hangup(chan);
                     res = -1;
                  } else {
                     if (locked_channel)
                        *locked_channel = chan;
                  }
               }
            }
         } else {
            ast_verb(4, "Channel %s was never answered.\n", ast_channel_name(chan));
            if (ast_channel_cdr(chan)) { /* update the cdr */
               /* here we update the status of the call, which sould be busy.
                * if that fails then we set the status to failed */
               if (ast_cdr_disposition(ast_channel_cdr(chan), ast_channel_hangupcause(chan)))
                  ast_cdr_failed(ast_channel_cdr(chan));
            }
            ast_hangup(chan);
         }
      }

      if (res < 0) { /* the call failed for some reason */
         if (*reason == 0) { /* if the call failed (not busy or no answer)
                        * update the cdr with the failed message */
            cdr_res = ast_pbx_outgoing_cdr_failed();
            if (cdr_res != 0) {
               res = cdr_res;
               goto outgoing_app_cleanup;
            }
         }
      }

   } else {
      struct async_stat *as;
      struct ast_callid *channel_callid;
      if (!(as = ast_calloc(1, sizeof(*as)))) {
         res = -1;
         goto outgoing_app_cleanup;
      }
      chan = __ast_request_and_dial(type, cap, NULL, addr, timeout, reason, cid_num, cid_name, &oh);
      if (!chan) {
         ast_free(as);
         res = -1;
         goto outgoing_app_cleanup;
      }

      /* Bind the newly created callid to the channel if it doesn't already have one on creation. */
      channel_callid = ast_channel_callid(chan);
      if (channel_callid) {
         ast_callid_unref(channel_callid);
      } else {
         if (callid) {
            ast_channel_callid_set(chan, callid);
         }
      }

      as->chan = chan;
      ast_copy_string(as->app, app, sizeof(as->app));
      if (appdata)
         ast_copy_string(as->appdata,  appdata, sizeof(as->appdata));
      as->timeout = timeout;
      ast_set_variables(chan, vars);
      if (account)
         ast_cdr_setaccount(chan, account);
      /* Start a new thread, and get something handling this channel. */
      if (locked_channel)
         ast_channel_lock(chan);
      if (ast_pthread_create_detached(&as->p, NULL, async_wait, as)) {
         ast_log(LOG_WARNING, "Failed to start async wait\n");
         ast_free(as);
         if (locked_channel)
            ast_channel_unlock(chan);
         ast_hangup(chan);
         res = -1;
         goto outgoing_app_cleanup;
      } else {
         if (locked_channel)
            *locked_channel = chan;
      }
      res = 0;
   }

outgoing_app_cleanup:
   ast_callid_threadstorage_auto_clean(callid, callid_created);
   ast_variables_destroy(vars);
   return res;
}

static int ast_pbx_outgoing_cdr_failed

(

void

)

[static]

Function to post an empty cdr after a spool call fails.

Note:

This function posts an empty cdr for a failed spool call

Definition at line 10339 of file pbx.c.

References ast_cdr_alloc(), ast_cdr_detach(), ast_cdr_end(), ast_cdr_failed(), ast_cdr_init(), ast_cdr_start(), ast_channel_cdr(), ast_channel_cdr_set(), ast_channel_unref, and ast_dummy_channel_alloc().

Referenced by ast_pbx_outgoing_app(), and ast_pbx_outgoing_exten().

{
   /* allocate a channel */
   struct ast_channel *chan = ast_dummy_channel_alloc();

   if (!chan)
      return -1;  /* failure */

   ast_channel_cdr_set(chan, ast_cdr_alloc());
   if (!ast_channel_cdr(chan)) {
      /* allocation of the cdr failed */
      chan = ast_channel_unref(chan);   /* free the channel */
      return -1;                /* return failure */
   }

   /* allocation of the cdr was successful */
   ast_cdr_init(ast_channel_cdr(chan), chan);  /* initialize our channel's cdr */
   ast_cdr_start(ast_channel_cdr(chan));       /* record the start and stop time */
   ast_cdr_end(ast_channel_cdr(chan));
   ast_cdr_failed(ast_channel_cdr(chan));      /* set the status to failed */
   ast_cdr_detach(ast_channel_cdr(chan));      /* post and free the record */
   ast_channel_cdr_set(chan, NULL);
   chan = ast_channel_unref(chan);         /* free the channel */

   return 0;  /* success */
}

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	sync,
		const char *	cid_num,
		const char *	cid_name,
		struct ast_variable *	vars,
		const char *	account,
		struct ast_channel **	locked_channel,
		int	early_media
	)

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

Definition at line 10366 of file pbx.c.

References __ast_request_and_dial(), outgoing_helper::account, ast_callid_threadstorage_auto(), ast_callid_threadstorage_auto_clean(), ast_callid_unref, ast_calloc, ast_cdr_disposition(), ast_cdr_failed(), ast_cdr_setaccount(), ast_channel_alloc(), ast_channel_callid(), ast_channel_callid_set(), ast_channel_cdr(), ast_channel_context_set(), ast_channel_hangupcause(), ast_channel_lock, ast_channel_name(), ast_channel_unlock, AST_CONTROL_PROGRESS, ast_copy_string(), ast_exists_extension(), ast_free, ast_hangup(), ast_log(), ast_pbx_outgoing_cdr_failed(), ast_pbx_run(), ast_pbx_start(), ast_pthread_create_detached, ast_request_and_dial(), ast_set_variables(), AST_STATE_DOWN, AST_STATE_UP, ast_strlen_zero(), ast_variables_destroy(), ast_verb, async_wait(), async_stat::chan, cid_name, outgoing_helper::cid_name, cid_num, outgoing_helper::cid_num, outgoing_helper::connect_on_early_media, context, outgoing_helper::context, async_stat::context, exten, outgoing_helper::exten, LOG_ERROR, LOG_WARNING, async_stat::p, outgoing_helper::parent_channel, pbx_builtin_setvar_helper(), outgoing_helper::priority, set_ext_pri(), async_stat::timeout, and outgoing_helper::vars.

Referenced by action_originate(), attempt_thread(), fast_originate(), orig_exten(), and originate_exec().

{
   struct ast_channel *chan;
   struct async_stat *as;
   struct ast_callid *callid;
   int callid_created = 0;
   int res = -1, cdr_res = -1;
   struct outgoing_helper oh;

   oh.connect_on_early_media = early_media;

   callid_created = ast_callid_threadstorage_auto(&callid);

   if (synchronous) {
      oh.context = context;
      oh.exten = exten;
      oh.priority = priority;
      oh.cid_num = cid_num;
      oh.cid_name = cid_name;
      oh.account = account;
      oh.vars = vars;
      oh.parent_channel = NULL;

      chan = __ast_request_and_dial(type, cap, NULL, addr, timeout, reason, cid_num, cid_name, &oh);
      if (channel) {
         *channel = chan;
         if (chan)
            ast_channel_lock(chan);
      }
      if (chan) {
         /* Bind the callid to the channel if it doesn't already have one on creation */
         struct ast_callid *channel_callid = ast_channel_callid(chan);
         if (channel_callid) {
            ast_callid_unref(channel_callid);
         } else {
            if (callid) {
               ast_channel_callid_set(chan, callid);
            }
         }

         if (ast_channel_state(chan) == AST_STATE_UP || (early_media && *reason == AST_CONTROL_PROGRESS)) {
               res = 0;
            ast_verb(4, "Channel %s %s\n", ast_channel_name(chan), ast_channel_state(chan) == AST_STATE_UP ? "was answered" : "got early media");

            if (synchronous > 1) {
               if (channel)
                  ast_channel_unlock(chan);
               if (ast_pbx_run(chan)) {
                  ast_log(LOG_ERROR, "Unable to run PBX on %s\n", ast_channel_name(chan));
                  if (channel)
                     *channel = NULL;
                  ast_hangup(chan);
                  chan = NULL;
                  res = -1;
               }
            } else {
               if (ast_pbx_start(chan)) {
                  ast_log(LOG_ERROR, "Unable to start PBX on %s\n", ast_channel_name(chan));
                  if (channel) {
                     *channel = NULL;
                     ast_channel_unlock(chan);
                  }
                  ast_hangup(chan);
                  res = -1;
               }
               chan = NULL;
            }
         } else {
            ast_verb(4, "Channel %s was never answered.\n", ast_channel_name(chan));

            if (ast_channel_cdr(chan)) { /* update the cdr */
               /* here we update the status of the call, which sould be busy.
                * if that fails then we set the status to failed */
               if (ast_cdr_disposition(ast_channel_cdr(chan), ast_channel_hangupcause(chan)))
                  ast_cdr_failed(ast_channel_cdr(chan));
            }

            if (channel) {
               *channel = NULL;
               ast_channel_unlock(chan);
            }
            ast_hangup(chan);
            chan = NULL;
         }
      }

      if (res < 0) { /* the call failed for some reason */
         if (*reason == 0) { /* if the call failed (not busy or no answer)
                        * update the cdr with the failed message */
            cdr_res = ast_pbx_outgoing_cdr_failed();
            if (cdr_res != 0) {
               res = cdr_res;
               goto outgoing_exten_cleanup;
            }
         }

         /* create a fake channel and execute the "failed" extension (if it exists) within the requested context */
         /* check if "failed" exists */
         if (ast_exists_extension(chan, context, "failed", 1, NULL)) {
            chan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "", "", "", NULL, 0, "OutgoingSpoolFailed");
            if (chan) {
               char failed_reason[4] = "";
               if (!ast_strlen_zero(context))
                  ast_channel_context_set(chan, context);
               set_ext_pri(chan, "failed", 1);
               ast_set_variables(chan, vars);
               snprintf(failed_reason, sizeof(failed_reason), "%d", *reason);
               pbx_builtin_setvar_helper(chan, "REASON", failed_reason);
               if (account)
                  ast_cdr_setaccount(chan, account);
               if (ast_pbx_run(chan)) {
                  ast_log(LOG_ERROR, "Unable to run PBX on %s\n", ast_channel_name(chan));
                  ast_hangup(chan);
               }
               chan = NULL;
            }
         }
      }
   } else {
      struct ast_callid *channel_callid;
      if (!(as = ast_calloc(1, sizeof(*as)))) {
         res = -1;
         goto outgoing_exten_cleanup;
      }
      chan = ast_request_and_dial(type, cap, NULL, addr, timeout, reason, cid_num, cid_name);
      if (channel) {
         *channel = chan;
         if (chan)
            ast_channel_lock(chan);
      }
      if (!chan) {
         ast_free(as);
         res = -1;
         goto outgoing_exten_cleanup;
      }

      /* Bind the newly created callid to the channel if it doesn't already have one on creation. */
      channel_callid = ast_channel_callid(chan);
      if (channel_callid) {
         ast_callid_unref(channel_callid);
      } else {
         if (callid) {
            ast_channel_callid_set(chan, callid);
         }
      }

      as->chan = chan;
      ast_copy_string(as->context, context, sizeof(as->context));
      set_ext_pri(as->chan,  exten, priority);
      as->timeout = timeout;
      ast_set_variables(chan, vars);
      if (account)
         ast_cdr_setaccount(chan, account);
      if (ast_pthread_create_detached(&as->p, NULL, async_wait, as)) {
         ast_log(LOG_WARNING, "Failed to start async wait\n");
         ast_free(as);
         if (channel) {
            *channel = NULL;
            ast_channel_unlock(chan);
         }
         ast_hangup(chan);
         res = -1;
         goto outgoing_exten_cleanup;
      }
      res = 0;
   }

outgoing_exten_cleanup:
   ast_callid_threadstorage_auto_clean(callid, callid_created);
   ast_variables_destroy(vars);
   return res;
}

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 6891 of file pbx.c.

References ast_pbx_run_args().

Referenced by __analog_ss_thread(), analog_ss_thread(), ast_pbx_outgoing_exten(), async_wait(), do_idle_thread(), do_notify(), mgcp_ss(), pri_ss_thread(), skinny_newcall(), and unistim_ss().

{
   return ast_pbx_run_args(c, NULL);
}

static void* ast_pbx_run_app

(

void *

data

)

[static]

run the application and free the descriptor once done

Definition at line 10549 of file pbx.c.

References app, app_tmp::app, ast_channel_name(), ast_free, ast_hangup(), ast_log(), ast_string_field_free_memory, ast_verb, app_tmp::chan, ast_sw::data, app_tmp::data, LOG_WARNING, pbx_exec(), and pbx_findapp().

Referenced by ast_pbx_outgoing_app().

{
   struct app_tmp *tmp = data;
   struct ast_app *app;
   app = pbx_findapp(tmp->app);
   if (app) {
      ast_verb(4, "Launching %s(%s) on %s\n", tmp->app, tmp->data, ast_channel_name(tmp->chan));
      pbx_exec(tmp->chan, app, tmp->data);
   } else
      ast_log(LOG_WARNING, "No such application '%s'\n", tmp->app);
   ast_hangup(tmp->chan);
   ast_string_field_free_memory(tmp);
   ast_free(tmp);
   return NULL;
}

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 6871 of file pbx.c.

References __ast_pbx_run(), ast_log(), AST_OPT_FLAG_FULLY_BOOTED, ast_options, AST_PBX_CALL_LIMIT, AST_PBX_FAILED, AST_PBX_SUCCESS, ast_test_flag, decrease_call_count(), increase_call_count(), and LOG_WARNING.

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

{
   enum ast_pbx_result res = AST_PBX_SUCCESS;

   if (!ast_test_flag(&ast_options, AST_OPT_FLAG_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;
}

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 6844 of file pbx.c.

References ast_log(), AST_OPT_FLAG_FULLY_BOOTED, ast_options, AST_PBX_CALL_LIMIT, AST_PBX_FAILED, AST_PBX_SUCCESS, ast_pthread_create_detached, ast_test_flag, decrease_call_count(), increase_call_count(), LOG_WARNING, and pbx_thread().

Referenced by __oh323_new(), alsa_new(), ast_async_goto(), ast_iax2_new(), ast_pbx_outgoing_exten(), bridge_call_thread(), bridge_exec(), check_goto_on_transfer(), console_new(), dahdi_new(), dial_exec_full(), generic_recall(), gtalk_new(), gtalk_newcall(), handle_request_invite(), jingle_action_session_initiate(), jingle_new(), jingle_newcall(), local_call(), manage_parked_call(), mgcp_new(), nbs_new(), oss_new(), pbx_start_chan(), phone_new(), pri_dchannel(), skinny_new(), ss7_start_call(), try_calling(), and unistim_new().

{
   pthread_t t;

   if (!c) {
      ast_log(LOG_WARNING, "Asked to start thread on NULL channel?\n");
      return AST_PBX_FAILED;
   }

   if (!ast_test_flag(&ast_options, AST_OPT_FLAG_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;
}

int ast_processed_calls

(

void

)

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

Definition at line 6901 of file pbx.c.

References totalcalls.

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

{
   return totalcalls;
}

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 12082 of file pbx.c.

References ast_rwlock_rdlock, and ast_context::lock.

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

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

int ast_rdlock_contexts

(

void

)

Read locks the context list.

Return values:

0	on success
-1	on error

Definition at line 12064 of file pbx.c.

References ast_mutex_lock, and conlock.

Referenced by _macro_exec(), ast_context_find(), ast_context_find_or_create(), ast_hint_extension(), 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_endwhile(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_extension_helper(), show_debug_helper(), show_dialplan_helper(), and unreference_cached_app().

{
   return ast_mutex_lock(&conlock);
}

int ast_register_application2	(	const char *	app,
		int(*)(struct ast_channel *, const char *)	execute,
		const char *	synopsis,
		const char *	description,
		void *	mod
	)

Dynamically register a new dial plan application.

Register an application.

Definition at line 7309 of file pbx.c.

References ast_app::arguments, ast_calloc, ast_free, ast_log(), ast_module_name(), AST_RWLIST_INSERT_BEFORE_CURRENT, AST_RWLIST_INSERT_TAIL, AST_RWLIST_TRAVERSE, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, AST_STATIC_DOC, ast_string_field_init, ast_string_field_set, ast_strlen_zero(), ast_verb, AST_XML_DOC, ast_xmldoc_build_arguments(), ast_xmldoc_build_description(), ast_xmldoc_build_seealso(), ast_xmldoc_build_synopsis(), ast_xmldoc_build_syntax(), COLOR_BRCYAN, ast_app::docsrc, ast_app::execute, LOG_WARNING, ast_app::seealso, ast_app::syntax, and term_color().

Referenced by ast_cc_init(), ast_features_init(), ast_msg_init(), and load_pbx().

{
   struct ast_app *tmp, *cur = NULL;
   char tmps[80];
   int length, res;
#ifdef AST_XML_DOCS
   char *tmpxml;
#endif

   AST_RWLIST_WRLOCK(&apps);
   AST_RWLIST_TRAVERSE(&apps, tmp, list) {
      if (!(res = strcasecmp(app, tmp->name))) {
         ast_log(LOG_WARNING, "Already have an application '%s'\n", app);
         AST_RWLIST_UNLOCK(&apps);
         return -1;
      } else if (res < 0)
         break;
   }

   length = sizeof(*tmp) + strlen(app) + 1;

   if (!(tmp = ast_calloc(1, length))) {
      AST_RWLIST_UNLOCK(&apps);
      return -1;
   }

   if (ast_string_field_init(tmp, 128)) {
      AST_RWLIST_UNLOCK(&apps);
      ast_free(tmp);
      return -1;
   }

   strcpy(tmp->name, app);
   tmp->execute = execute;
   tmp->module = mod;

#ifdef AST_XML_DOCS
   /* Try to lookup the docs in our XML documentation database */
   if (ast_strlen_zero(synopsis) && ast_strlen_zero(description)) {
      /* load synopsis */
      tmpxml = ast_xmldoc_build_synopsis("application", app, ast_module_name(tmp->module));
      ast_string_field_set(tmp, synopsis, tmpxml);
      ast_free(tmpxml);

      /* load description */
      tmpxml = ast_xmldoc_build_description("application", app, ast_module_name(tmp->module));
      ast_string_field_set(tmp, description, tmpxml);
      ast_free(tmpxml);

      /* load syntax */
      tmpxml = ast_xmldoc_build_syntax("application", app, ast_module_name(tmp->module));
      ast_string_field_set(tmp, syntax, tmpxml);
      ast_free(tmpxml);

      /* load arguments */
      tmpxml = ast_xmldoc_build_arguments("application", app, ast_module_name(tmp->module));
      ast_string_field_set(tmp, arguments, tmpxml);
      ast_free(tmpxml);

      /* load seealso */
      tmpxml = ast_xmldoc_build_seealso("application", app, ast_module_name(tmp->module));
      ast_string_field_set(tmp, seealso, tmpxml);
      ast_free(tmpxml);
      tmp->docsrc = AST_XML_DOC;
   } else {
#endif
      ast_string_field_set(tmp, synopsis, synopsis);
      ast_string_field_set(tmp, description, description);
#ifdef AST_XML_DOCS
      tmp->docsrc = AST_STATIC_DOC;
   }
#endif

   /* Store in alphabetical order */
   AST_RWLIST_TRAVERSE_SAFE_BEGIN(&apps, cur, list) {
      if (strcasecmp(tmp->name, cur->name) < 0) {
         AST_RWLIST_INSERT_BEFORE_CURRENT(tmp, list);
         break;
      }
   }
   AST_RWLIST_TRAVERSE_SAFE_END;
   if (!cur)
      AST_RWLIST_INSERT_TAIL(&apps, tmp, list);

   ast_verb(2, "Registered application '%s'\n", term_color(tmps, tmp->name, COLOR_BRCYAN, 0, sizeof(tmps)));

   AST_RWLIST_UNLOCK(&apps);

   return 0;
}

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 7404 of file pbx.c.

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

Referenced by load_module().

{
   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;
}

static int ast_remove_hint

(

struct ast_exten *

e

)

[static]

Remove hint from extension.

Definition at line 5822 of file pbx.c.

References ao2_find, ao2_lock, ao2_ref, ao2_unlock, ast_copy_string(), ast_get_context_name(), ast_get_extension_context(), ast_get_extension_name(), ast_hint::context_name, ast_hint::exten, ast_hint::exten_name, OBJ_UNLINK, and remove_hintdevice().

Referenced by destroy_exten().

{
   /* Cleanup the Notifys if hint is removed */
   struct ast_hint *hint;

   if (!e) {
      return -1;
   }

   hint = ao2_find(hints, e, OBJ_UNLINK);
   if (!hint) {
      return -1;
   }

   remove_hintdevice(hint);

   /*
    * The extension is being destroyed so we must save some
    * information to notify that the extension is deactivated.
    */
   ao2_lock(hint);
   ast_copy_string(hint->context_name,
      ast_get_context_name(ast_get_extension_context(hint->exten)),
      sizeof(hint->context_name));
   ast_copy_string(hint->exten_name, ast_get_extension_name(hint->exten),
      sizeof(hint->exten_name));
   hint->exten = NULL;
   ao2_unlock(hint);

   ao2_ref(hint, -1);

   return 0;
}

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 6029 of file pbx.c.

References E_SPAWN, and pbx_extension_helper().

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

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

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
	)

Get hint for channel.

If an extension hint exists, return non-zero.

Definition at line 5984 of file pbx.c.

References ast_get_extension_app(), ast_get_extension_app_data(), ast_hint_extension(), and ast_str_set().

Referenced by ast_str_retrieve_variable().

{
   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;
}

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 3542 of file pbx.c.

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_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_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_var_name(), ast_var_value(), ast_var_t::entries, globalslock, and parse_variable_name().

Referenced by ast_str_substitute_variables_full(), and pbx_retrieve_variable().

{
   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, "%u", (int) time(NULL));
         s = ast_str_buffer(*str);
      } else if (!strcmp(var, "SYSTEMNAME")) {
         s = ast_config_AST_SYSTEM_NAME;
      } 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, "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 (!strcasecmp(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;
}

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 4585 of file pbx.c.

References ast_str_substitute_variables_full().

Referenced by _macro_exec(), acf_odbc_read(), acf_odbc_write(), 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_getvariablefull(), import_helper(), listfilter(), make_email_file(), realtime_curl(), realtime_multi_curl(), replace(), require_curl(), sendmail(), sendpage(), shift_pop(), store_curl(), strreplace(), syslog_log(), tryexec_exec(), unshift_push(), update2_curl(), and update_curl().

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

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.

Definition at line 4406 of file pbx.c.

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_full(), ast_str_substring(), ast_strlen_zero(), len(), LOG_ERROR, LOG_WARNING, and parse_variable_name().

Referenced by ast_str_substitute_variables(), ast_str_substitute_variables_full(), and ast_str_substitute_variables_varshead().

{
   /* Substitutes variables into buf, based on string templ */
   char *cp4 = NULL;
   const char *whereweare;
   int orig_size = 0;
   int offset, offset2, isfunction;
   const char *nextvar, *nextexp, *nextthing;
   const char *vars, *vare;
   char *finalvars;
   int pos, brackets, needsub, len;
   struct ast_str *substr1 = ast_str_create(16), *substr2 = NULL, *substr3 = ast_str_create(16);

   ast_str_reset(*buf);
   whereweare = templ;
   while (!ast_strlen_zero(whereweare)) {
      /* reset our buffer */
      ast_str_reset(substr3);

      /* Assume we're copying the whole remaining string */
      pos = strlen(whereweare);
      nextvar = NULL;
      nextexp = NULL;
      nextthing = strchr(whereweare, '$');
      if (nextthing) {
         switch (nextthing[1]) {
         case '{':
            nextvar = nextthing;
            pos = nextvar - whereweare;
            break;
         case '[':
            nextexp = nextthing;
            pos = nextexp - whereweare;
            break;
         default:
            pos = 1;
         }
      }

      if (pos) {
         /* Copy that many bytes */
         ast_str_append_substr(buf, maxlen, whereweare, pos);

         templ += pos;
         whereweare += pos;
      }

      if (nextvar) {
         /* 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++;
            } else if (vare[0] == '{') {
               brackets++;
            } else if (vare[0] == '}') {
               brackets--;
            } else if ((vare[0] == '$') && (vare[1] == '['))
               needsub++;
            vare++;
         }
         if (brackets)
            ast_log(LOG_WARNING, "Error in extension logic (missing '}')\n");
         len = vare - vars - 1;

         /* Skip totally over variable string */
         whereweare += (len + 3);

         /* Store variable name (and truncate) */
         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) {
            size_t used;
            if (!substr2) {
               substr2 = ast_str_create(16);
            }

            ast_str_substitute_variables_full(&substr2, 0, c, headp, ast_str_buffer(substr1), &used);
            finalvars = ast_str_buffer(substr2);
         } else {
            finalvars = ast_str_buffer(substr1);
         }

         parse_variable_name(finalvars, &offset, &offset2, &isfunction);
         if (isfunction) {
            /* Evaluate function */
            if (c || !headp) {
               cp4 = ast_func_read2(c, finalvars, &substr3, 0) ? NULL : ast_str_buffer(substr3);
            } else {
               struct varshead old;
               struct ast_channel *bogus = ast_dummy_channel_alloc();
               if (bogus) {
                  memcpy(&old, ast_channel_varshead(bogus), sizeof(old));
                  memcpy(ast_channel_varshead(bogus), headp, sizeof(*ast_channel_varshead(bogus)));
                  cp4 = ast_func_read2(c, finalvars, &substr3, 0) ? NULL : ast_str_buffer(substr3);
                  /* Don't deallocate the varshead that was passed in */
                  memcpy(ast_channel_varshead(bogus), &old, sizeof(*ast_channel_varshead(bogus)));
                  ast_channel_unref(bogus);
               } else {
                  ast_log(LOG_ERROR, "Unable to allocate bogus channel for variable substitution.  Function results may be blank.\n");
               }
            }
            ast_debug(2, "Function %s result is '%s'\n", finalvars, cp4 ? cp4 : "(null)");
         } else {
            /* Retrieve variable value */
            ast_str_retrieve_variable(&substr3, 0, c, headp, finalvars);
            cp4 = ast_str_buffer(substr3);
         }
         if (cp4) {
            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++;
         }
         if (brackets)
            ast_log(LOG_WARNING, "Error in extension logic (missing ']')\n");
         len = vare - vars - 1;

         /* Skip totally over expression */
         whereweare += (len + 3);

         /* Store variable name (and truncate) */
         ast_str_set_substr(&substr1, 0, vars, len);

         /* Substitute if necessary */
         if (needsub) {
            size_t used;
            if (!substr2) {
               substr2 = ast_str_create(16);
            }

            ast_str_substitute_variables_full(&substr2, 0, c, headp, ast_str_buffer(substr1), &used);
            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));
      }
   }
   *used = ast_str_strlen(*buf) - orig_size;
   ast_free(substr1);
   ast_free(substr2);
   ast_free(substr3);
}

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 4591 of file pbx.c.

References ast_str_substitute_variables_full().

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

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

static const char* ast_str_substring	(	struct ast_str *	value,
		int	offset,
		int	length
	)		[static]

Definition at line 3477 of file pbx.c.

References ast_str_buffer(), ast_str_reset(), ast_str_strlen(), and ast_str_update().

Referenced by ast_str_retrieve_variable(), and ast_str_substitute_variables_full().

{
   int lr;  /* length of the input string after the copy */

   lr = ast_str_strlen(value); /* compute length after copy, so we never go out of the workspace */

   /* Quick check if no need to do anything */
   if (offset == 0 && length >= lr) /* take the whole string */
      return ast_str_buffer(value);

   if (offset < 0)   {  /* translate negative offset into positive ones */
      offset = lr + offset;
      if (offset < 0) /* If the negative offset was greater than the length of the string, just start at the beginning */
         offset = 0;
   }

   /* too large offset result in empty string so we know what to return */
   if (offset >= lr) {
      ast_str_reset(value);
      return ast_str_buffer(value);
   }

   if (offset > 0) {
      /* Go ahead and chop off the beginning */
      memmove(ast_str_buffer(value), ast_str_buffer(value) + offset, ast_str_strlen(value) - offset + 1);
      lr -= offset;
   }

   if (length >= 0 && length < lr) {   /* truncate if necessary */
      char *tmp = ast_str_buffer(value);
      tmp[length] = '\0';
      ast_str_update(value);
   } else if (length < 0) {
      if (lr > -length) { /* After we remove from the front and from the rear, is there anything left? */
         char *tmp = ast_str_buffer(value);
         tmp[lr + length] = '\0';
         ast_str_update(value);
      } else {
         ast_str_reset(value);
      }
   } else {
      /* Nothing to do, but update the buffer length */
      ast_str_update(value);
   }

   return ast_str_buffer(value);
}

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 4189 of file pbx.c.

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

Referenced by handle_tcptls_connection().

{
   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;
}

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 12087 of file pbx.c.

References ast_rwlock_unlock, and ast_context::lock.

Referenced by __ast_context_destroy(), _macro_exec(), 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_endwhile(), handle_cli_dialplan_save(), lookup_c_ip(), lookup_ci(), manager_show_dialplan_helper(), show_debug_helper(), and show_dialplan_helper().

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

int ast_unlock_contexts

(

void

)

Unlocks contexts.

Return values:

0	on success
-1	on failure

Definition at line 12069 of file pbx.c.

References ast_mutex_unlock, and conlock.

Referenced by _macro_exec(), ast_add_extension(), ast_context_add_ignorepat(), ast_context_add_include(), ast_context_add_switch(), ast_context_destroy(), ast_context_find(), ast_context_find_or_create(), ast_context_lockmacro(), ast_context_remove_extension_callerid(), ast_context_remove_ignorepat(), ast_context_remove_include(), ast_context_remove_switch(), ast_context_unlockmacro(), ast_hint_extension(), ast_merge_contexts_and_delete(), 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_endwhile(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_extension_helper(), show_debug_helper(), show_dialplan_helper(), and unreference_cached_app().

{
   return ast_mutex_unlock(&conlock);
}

int ast_unregister_application

(

const char *

app

)

Unregister an application.

Parameters:

app	name of the application (does not have to be the same string as the one that was registered)

This unregisters an application from Asterisk's internal application list.

Return values:

0	success
-1	failure

Definition at line 8657 of file pbx.c.

References ast_free, AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_string_field_free_memory, ast_verb, and unreference_cached_app().

Referenced by __unload_module(), cc_shutdown(), features_shutdown(), load_module(), message_shutdown(), unload_module(), and unload_pbx().

{
   struct ast_app *tmp;

   AST_RWLIST_WRLOCK(&apps);
   AST_RWLIST_TRAVERSE_SAFE_BEGIN(&apps, tmp, list) {
      if (!strcasecmp(app, tmp->name)) {
         unreference_cached_app(tmp);
         AST_RWLIST_REMOVE_CURRENT(list);
         ast_verb(2, "Unregistered application '%s'\n", tmp->name);
         ast_string_field_free_memory(tmp);
         ast_free(tmp);
         break;
      }
   }
   AST_RWLIST_TRAVERSE_SAFE_END;
   AST_RWLIST_UNLOCK(&apps);

   return tmp ? 0 : -1;
}

void ast_unregister_switch

(

struct ast_switch *

sw

)

Unregister an alternative switch.

Parameters:

sw	switch to unregister

Unregisters a switch from asterisk.

Returns:

nothing

Definition at line 7422 of file pbx.c.

References AST_RWLIST_REMOVE, AST_RWLIST_UNLOCK, and AST_RWLIST_WRLOCK.

Referenced by __unload_module(), and unload_module().

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

struct ast_exten* ast_walk_context_extensions	(	struct ast_context *	con,
		struct ast_exten *	exten
	)		[read]

Definition at line 12201 of file pbx.c.

References ast_exten::next, 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().

{
   if (!exten)
      return con ? con->root : NULL;
   else
      return exten->next;
}

struct ast_ignorepat* ast_walk_context_ignorepats	(	struct ast_context *	con,
		struct ast_ignorepat *	ip
	)		[read]

Definition at line 12234 of file pbx.c.

References ast_context::ignorepats, and ast_ignorepat::next.

Referenced by 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().

{
   if (!ip)
      return con ? con->ignorepats : NULL;
   else
      return ip->next;
}

struct ast_include* ast_walk_context_includes	(	struct ast_context *	con,
		struct ast_include *	inc
	)		[read]

Definition at line 12225 of file pbx.c.

References ast_context::includes, and ast_include::next.

Referenced by ast_context_verify_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(), and show_dialplan_helper().

{
   if (!inc)
      return con ? con->includes : NULL;
   else
      return inc->next;
}

struct ast_sw* ast_walk_context_switches	(	struct ast_context *	con,
		struct ast_sw *	sw
	)		[read]

Definition at line 12210 of file pbx.c.

References ast_context::alts, AST_LIST_FIRST, and AST_LIST_NEXT.

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

{
   if (!sw)
      return con ? AST_LIST_FIRST(&con->alts) : NULL;
   else
      return AST_LIST_NEXT(sw, list);
}

struct ast_context* ast_walk_contexts

(

struct ast_context *

con

)

[read]

Definition at line 12196 of file pbx.c.

References contexts, and ast_context::next.

Referenced by _macro_exec(), 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_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().

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

struct ast_exten* ast_walk_extension_priorities	(	struct ast_exten *	exten,
		struct ast_exten *	priority
	)		[read]

Definition at line 12219 of file pbx.c.

References exten, and ast_exten::peer.

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

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

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 12077 of file pbx.c.

References ast_rwlock_wrlock, and ast_context::lock.

Referenced by __ast_context_destroy(), 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(), and ast_context_remove_switch2().

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

int ast_wrlock_contexts

(

void

)

Write locks the context list.

Return values:

0	on success
-1	on error

Definition at line 12059 of file pbx.c.

References ast_mutex_lock, and conlock.

Referenced by ast_context_destroy(), ast_context_find_or_create(), ast_merge_contexts_and_delete(), and complete_dialplan_remove_include().

{
   return ast_mutex_lock(&conlock);
}

static void* async_wait

(

void *

data

)

[static]

Definition at line 10259 of file pbx.c.

References app, async_stat::app, async_stat::appdata, ast_callid_threadassoc_add(), ast_callid_unref, ast_channel_callid(), ast_channel_context_set(), ast_channel_exten_set(), ast_channel_name(), ast_channel_priority_set(), AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_PROGRESS, ast_debug, AST_FRAME_CONTROL, ast_free, ast_frfree, ast_hangup(), ast_log(), ast_pbx_run(), ast_read(), ast_remaining_ms(), AST_STATE_UP, ast_strlen_zero(), ast_tvnow(), ast_verb, ast_waitfor(), async_stat::chan, async_stat::context, ast_sw::data, async_stat::early_media, async_stat::exten, f, ast_frame::frametype, ast_frame_subclass::integer, LOG_ERROR, LOG_WARNING, pbx_exec(), pbx_findapp(), async_stat::priority, ast_frame::subclass, and async_stat::timeout.

Referenced by ast_pbx_outgoing_app(), and ast_pbx_outgoing_exten().

{
   struct async_stat *as = data;
   struct ast_channel *chan = as->chan;
   int timeout = as->timeout;
   int res;
   struct ast_frame *f;
   struct ast_app *app;
   int have_early_media = 0;
   struct timeval start = ast_tvnow();
   int ms;

   if (chan) {
      struct ast_callid *callid = ast_channel_callid(chan);
      if (callid) {
         ast_callid_threadassoc_add(callid);
         ast_callid_unref(callid);
      }
   }

   while ((ms = ast_remaining_ms(start, timeout)) &&
         ast_channel_state(chan) != AST_STATE_UP) {
      res = ast_waitfor(chan, ms);
      if (res < 1)
         break;

      f = ast_read(chan);
      if (!f)
         break;
      if (f->frametype == AST_FRAME_CONTROL) {
         if ((f->subclass.integer == AST_CONTROL_BUSY)  ||
             (f->subclass.integer == AST_CONTROL_CONGESTION) ) {
            ast_frfree(f);
            break;
         }
         if (as->early_media && f->subclass.integer == AST_CONTROL_PROGRESS) {
            have_early_media = 1;
            ast_frfree(f);
            break;
         }
      }
      ast_frfree(f);
   }
   if (ast_channel_state(chan) == AST_STATE_UP || have_early_media) {
      if (have_early_media) {
         ast_debug(2, "Activating pbx since we have early media \n");
      }
      if (!ast_strlen_zero(as->app)) {
         app = pbx_findapp(as->app);
         if (app) {
            ast_verb(3, "Launching %s(%s) on %s\n", as->app, as->appdata, ast_channel_name(chan));
            pbx_exec(chan, app, as->appdata);
         } else
            ast_log(LOG_WARNING, "No such application '%s'\n", as->app);
      } else {
         if (!ast_strlen_zero(as->context))
            ast_channel_context_set(chan, as->context);
         if (!ast_strlen_zero(as->exten))
            ast_channel_exten_set(chan, as->exten);
         if (as->priority > 0)
            ast_channel_priority_set(chan, as->priority);
         /* Run the PBX */
         if (ast_pbx_run(chan)) {
            ast_log(LOG_ERROR, "Failed to start PBX on %s\n", ast_channel_name(chan));
         } else {
            /* PBX will have taken care of this */
            chan = NULL;
         }
      }
   }
   ast_free(as);
   if (chan)
      ast_hangup(chan);
   return NULL;
}

static void cli_match_char_tree	(	struct match_char *	node,
		char *	prefix,
		int	fd
	)		[static]

Definition at line 1796 of file pbx.c.

References match_char::alt_char, ast_cli(), ast_str_alloca, ast_str_buffer(), ast_str_set(), match_char::deleted, ast_exten::exten, match_char::exten, match_char::is_pattern, match_char::next_char, match_char::specificity, and match_char::x.

Referenced by show_debug_helper().

{
   char extenstr[40];
   struct ast_str *my_prefix = ast_str_alloca(1024);

   extenstr[0] = '\0';

   if (node->exten) {
      snprintf(extenstr, sizeof(extenstr), "(%p)", node->exten);
   }

   if (strlen(node->x) > 1) {
      ast_cli(fd, "%s[%s]:%c:%c:%d:%s%s%s\n", prefix, node->x, node->is_pattern ? 'Y' : 'N',
         node->deleted ? 'D' : '-', node->specificity, node->exten? "EXTEN:" : "",
         node->exten ? node->exten->exten : "", extenstr);
   } else {
      ast_cli(fd, "%s%s:%c:%c:%d:%s%s%s\n", prefix, node->x, node->is_pattern ? 'Y' : 'N',
         node->deleted ? 'D' : '-', node->specificity, node->exten? "EXTEN:" : "",
         node->exten ? node->exten->exten : "", extenstr);
   }

   ast_str_set(&my_prefix, 0, "%s+       ", prefix);

   if (node->next_char)
      cli_match_char_tree(node->next_char, ast_str_buffer(my_prefix), fd);

   if (node->alt_char)
      cli_match_char_tree(node->alt_char, prefix, fd);
}

static int collect_digits	(	struct ast_channel *	c,
		int	waittime,
		char *	buf,
		int	buflen,
		int	pos
	)		[static]

collect digits from the channel into the buffer.

Parameters:

c,buf,buflen,pos
waittime	is in milliseconds

Return values:

0	on timeout or done.
-1	on error.

Definition at line 6404 of file pbx.c.

References ast_channel_caller(), ast_channel_clear_softhangup(), ast_channel_context(), ast_channel_pbx(), ast_channel_softhangup_internal_flag(), ast_matchmore_extension(), AST_SOFTHANGUP_ASYNCGOTO, ast_waitfordigit(), ast_pbx::dtimeoutms, and S_COR.

Referenced by __ast_pbx_run().

{
   int digit;

   buf[pos] = '\0';  /* make sure it is properly terminated */
   while (ast_matchmore_extension(c, ast_channel_context(c), buf, 1,
      S_COR(ast_channel_caller(c)->id.number.valid, ast_channel_caller(c)->id.number.str, NULL))) {
      /* As long as we're willing to wait, and as long as it's not defined,
         keep reading digits until we can't possibly get a right answer anymore.  */
      digit = ast_waitfordigit(c, waittime);
      if (ast_channel_softhangup_internal_flag(c) & AST_SOFTHANGUP_ASYNCGOTO) {
         ast_channel_clear_softhangup(c, AST_SOFTHANGUP_ASYNCGOTO);
      } else {
         if (!digit) /* No entry */
            break;
         if (digit < 0) /* Error, maybe a  hangup */
            return -1;
         if (pos < buflen - 1) { /* XXX maybe error otherwise ? */
            buf[pos++] = digit;
            buf[pos] = '\0';
         }
         waittime = ast_channel_pbx(c)->dtimeoutms;
      }
   }
   return 0;
}

static int compare_char	(	const void *	a,
		const void *	b
	)		[static]

Definition at line 1224 of file pbx.c.

Referenced by get_pattern_node().

{
   const unsigned char *ac = a;
   const unsigned char *bc = b;

   return *ac - *bc;
}

static char* complete_core_show_hint	(	const char *	line,
		const char *	word,
		int	pos,
		int	state
	)		[static]

autocomplete for CLI command 'core show hint'

Definition at line 7609 of file pbx.c.

References ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_get_extension_name(), ast_strdup, and ast_hint::exten.

Referenced by handle_show_hint().

{
   struct ast_hint *hint;
   char *ret = NULL;
   int which = 0;
   int wordlen;
   struct ao2_iterator i;

   if (pos != 3)
      return NULL;

   wordlen = strlen(word);

   /* walk through all hints */
   i = ao2_iterator_init(hints, 0);
   for (; (hint = ao2_iterator_next(&i)); ao2_ref(hint, -1)) {
      ao2_lock(hint);
      if (!hint->exten) {
         /* The extension has already been destroyed */
         ao2_unlock(hint);
         continue;
      }
      if (!strncasecmp(word, ast_get_extension_name(hint->exten), wordlen) && ++which > state) {
         ret = ast_strdup(ast_get_extension_name(hint->exten));
         ao2_unlock(hint);
         ao2_ref(hint, -1);
         break;
      }
      ao2_unlock(hint);
   }
   ao2_iterator_destroy(&i);

   return ret;
}

static char* complete_show_dialplan_context	(	const char *	line,
		const char *	word,
		int	pos,
		int	state
	)		[static]

Definition at line 7819 of file pbx.c.

References ast_get_context_name(), ast_rdlock_contexts(), ast_strdup, ast_unlock_contexts(), and ast_walk_contexts().

Referenced by handle_debug_dialplan(), and handle_show_dialplan().

{
   struct ast_context *c = NULL;
   char *ret = NULL;
   int which = 0;
   int wordlen;

   /* we are do completion of [exten@]context on second position only */
   if (pos != 2)
      return NULL;

   ast_rdlock_contexts();

   wordlen = strlen(word);

   /* walk through all contexts and return the n-th match */
   while ( (c = ast_walk_contexts(c)) ) {
      if (!strncasecmp(word, ast_get_context_name(c), wordlen) && ++which > state) {
         ret = ast_strdup(ast_get_context_name(c));
         break;
      }
   }

   ast_unlock_contexts();

   return ret;
}

static void context_merge	(	struct ast_context **	extcontexts,
		struct ast_hashtab *	exttable,
		struct ast_context *	context,
		const char *	registrar
	)		[static]

Definition at line 8802 of file pbx.c.

References ast_exten::app, ast_add_extension2(), ast_context_find_or_create(), ast_hashtab_end_traversal(), ast_hashtab_lookup(), ast_hashtab_next(), ast_hashtab_start_traversal(), ast_log(), ast_strdup, ast_verb, ast_exten::cidmatch, context_merge_incls_swits_igps_other_registrars(), ast_exten::data, ast_exten::datad, ast_exten::exten, first, ast_exten::label, LOG_ERROR, ast_exten::matchcid, ast_context::name, ast_exten::peer_table, ast_exten::priority, ast_context::refcount, ast_exten::registrar, ast_context::registrar, and ast_context::root_table.

Referenced by ast_merge_contexts_and_delete().

{
   struct ast_context *new = ast_hashtab_lookup(exttable, context); /* is there a match in the new set? */
   struct ast_exten *exten_item, *prio_item, *new_exten_item, *new_prio_item;
   struct ast_hashtab_iter *exten_iter;
   struct ast_hashtab_iter *prio_iter;
   int insert_count = 0;
   int first = 1;

   /* We'll traverse all the extensions/prios, and see which are not registrar'd with
      the current registrar, and copy them to the new context. If the new context does not
      exist, we'll create it "on demand". If no items are in this context to copy, then we'll
      only create the empty matching context if the old one meets the criteria */

   if (context->root_table) {
      exten_iter = ast_hashtab_start_traversal(context->root_table);
      while ((exten_item=ast_hashtab_next(exten_iter))) {
         if (new) {
            new_exten_item = ast_hashtab_lookup(new->root_table, exten_item);
         } else {
            new_exten_item = NULL;
         }
         prio_iter = ast_hashtab_start_traversal(exten_item->peer_table);
         while ((prio_item=ast_hashtab_next(prio_iter))) {
            int res1;
            char *dupdstr;

            if (new_exten_item) {
               new_prio_item = ast_hashtab_lookup(new_exten_item->peer_table, prio_item);
            } else {
               new_prio_item = NULL;
            }
            if (strcmp(prio_item->registrar,registrar) == 0) {
               continue;
            }
            /* make sure the new context exists, so we have somewhere to stick this exten/prio */
            if (!new) {
               new = ast_context_find_or_create(extcontexts, exttable, context->name, prio_item->registrar); /* a new context created via priority from a different context in the old dialplan, gets its registrar from the prio's registrar */
            }

            /* copy in the includes, switches, and ignorepats */
            if (first) { /* but, only need to do this once */
               context_merge_incls_swits_igps_other_registrars(new, context, registrar);
               first = 0;
            }

            if (!new) {
               ast_log(LOG_ERROR,"Could not allocate a new context for %s in merge_and_delete! Danger!\n", context->name);
               ast_hashtab_end_traversal(prio_iter);
               ast_hashtab_end_traversal(exten_iter);
               return; /* no sense continuing. */
            }
            /* we will not replace existing entries in the new context with stuff from the old context.
               but, if this is because of some sort of registrar conflict, we ought to say something... */

            dupdstr = ast_strdup(prio_item->data);

            res1 = ast_add_extension2(new, 0, prio_item->exten, prio_item->priority, prio_item->label,
                                prio_item->matchcid ? prio_item->cidmatch : NULL, prio_item->app, dupdstr, prio_item->datad, prio_item->registrar);
            if (!res1 && new_exten_item && new_prio_item){
               ast_verb(3,"Dropping old dialplan item %s/%s/%d [%s(%s)] (registrar=%s) due to conflict with new dialplan\n",
                     context->name, prio_item->exten, prio_item->priority, prio_item->app, (char*)prio_item->data, prio_item->registrar);
            } else {
               /* we do NOT pass the priority data from the old to the new -- we pass a copy of it, so no changes to the current dialplan take place,
                and no double frees take place, either! */
               insert_count++;
            }
         }
         ast_hashtab_end_traversal(prio_iter);
      }
      ast_hashtab_end_traversal(exten_iter);
   }

   if (!insert_count && !new && (strcmp(context->registrar, registrar) != 0 ||
        (strcmp(context->registrar, registrar) == 0 && context->refcount > 1))) {
      /* we could have given it the registrar of the other module who incremented the refcount,
         but that's not available, so we give it the registrar we know about */
      new = ast_context_find_or_create(extcontexts, exttable, context->name, context->registrar);

      /* copy in the includes, switches, and ignorepats */
      context_merge_incls_swits_igps_other_registrars(new, context, registrar);
   }
}

static void context_merge_incls_swits_igps_other_registrars	(	struct ast_context *	new,
		struct ast_context *	old,
		const char *	registrar
	)		[static]

Definition at line 8769 of file pbx.c.

References ast_context_add_ignorepat2(), ast_context_add_include2(), ast_context_add_switch2(), ast_get_context_name(), ast_get_ignorepat_name(), ast_get_ignorepat_registrar(), ast_get_include_name(), ast_get_include_registrar(), ast_get_switch_data(), ast_get_switch_eval(), ast_get_switch_name(), ast_get_switch_registrar(), ast_verb, ast_walk_context_ignorepats(), ast_walk_context_includes(), ast_walk_context_switches(), and ast_sw::registrar.

Referenced by context_merge().

{
   struct ast_include *i;
   struct ast_ignorepat *ip;
   struct ast_sw *sw;

   ast_verb(3, "merging incls/swits/igpats from old(%s) to new(%s) context, registrar = %s\n", ast_get_context_name(old), ast_get_context_name(new), registrar);
   /* copy in the includes, switches, and ignorepats */
   /* walk through includes */
   for (i = NULL; (i = ast_walk_context_includes(old, i)) ; ) {
      if (strcmp(ast_get_include_registrar(i), registrar) == 0)
         continue; /* not mine */
      ast_context_add_include2(new, ast_get_include_name(i), ast_get_include_registrar(i));
   }

   /* walk through switches */
   for (sw = NULL; (sw = ast_walk_context_switches(old, sw)) ; ) {
      if (strcmp(ast_get_switch_registrar(sw), registrar) == 0)
         continue; /* not mine */
      ast_context_add_switch2(new, ast_get_switch_name(sw), ast_get_switch_data(sw), ast_get_switch_eval(sw), ast_get_switch_registrar(sw));
   }

   /* walk thru ignorepats ... */
   for (ip = NULL; (ip = ast_walk_context_ignorepats(old, ip)); ) {
      if (strcmp(ast_get_ignorepat_registrar(ip), registrar) == 0)
         continue; /* not mine */
      ast_context_add_ignorepat2(new, ast_get_ignorepat_name(ip), ast_get_ignorepat_registrar(ip));
   }
}

static void create_match_char_tree

(

struct ast_context *

con

)

[static]

Definition at line 2418 of file pbx.c.

References add_exten_to_pattern_tree(), ast_debug, ast_hashtab_end_traversal(), ast_hashtab_get_stats(), ast_hashtab_next(), ast_hashtab_start_traversal(), ast_log(), ast_exten::exten, LOG_ERROR, ast_context::name, ast_context::root_table, and t1.

Referenced by pbx_find_extension().

{
   struct ast_hashtab_iter *t1;
   struct ast_exten *e1;
#ifdef NEED_DEBUG
   int biggest_bucket, resizes, numobjs, numbucks;

   ast_debug(1, "Creating Extension Trie for context %s(%p)\n", con->name, con);
   ast_hashtab_get_stats(con->root_table, &biggest_bucket, &resizes, &numobjs, &numbucks);
   ast_debug(1, "This tree has %d objects in %d bucket lists, longest list=%d objects, and has resized %d times\n",
         numobjs, numbucks, biggest_bucket, resizes);
#endif
   t1 = ast_hashtab_start_traversal(con->root_table);
   while ((e1 = ast_hashtab_next(t1))) {
      if (e1->exten) {
         add_exten_to_pattern_tree(con, e1, 0);
      } else {
         ast_log(LOG_ERROR, "Attempt to create extension with no extension name.\n");
      }
   }
   ast_hashtab_end_traversal(t1);
}

static void decrease_call_count

(

void

)

[static]

Definition at line 6802 of file pbx.c.

References ast_mutex_lock, ast_mutex_unlock, and maxcalllock.

Referenced by ast_pbx_run_args(), ast_pbx_start(), and pbx_thread().

{
   ast_mutex_lock(&maxcalllock);
   if (countcalls > 0)
      countcalls--;
   ast_mutex_unlock(&maxcalllock);
}

static void destroy_exten

(

struct ast_exten *

e

)

[static]

Definition at line 6810 of file pbx.c.

References ast_free, ast_hashtab_destroy(), ast_remove_hint(), ast_exten::data, ast_exten::datad, ast_exten::peer_label_table, ast_exten::peer_table, ast_exten::priority, and PRIORITY_HINT.

Referenced by __ast_internal_context_destroy(), and ast_context_remove_extension_callerid2().

{
   if (e->priority == PRIORITY_HINT)
      ast_remove_hint(e);

   if (e->peer_table)
      ast_hashtab_destroy(e->peer_table,0);
   if (e->peer_label_table)
      ast_hashtab_destroy(e->peer_label_table, 0);
   if (e->datad)
      e->datad(e->data);
   ast_free(e);
}

static void destroy_hint

(

void *

obj

)

[static]

Definition at line 5785 of file pbx.c.

References ao2_callback, ao2_ref, AST_EXTENSION_DEACTIVATED, ast_free, ast_get_context_name(), ast_get_extension_context(), ast_get_extension_name(), AST_HINT_UPDATE_DEVICE, ast_hint::callbacks, ast_state_cb::change_cb, ast_hint::context_name, ast_state_cb::data, execute_state_callback(), ast_hint::exten, ast_hint::exten_name, ast_hint::last_presence_message, ast_hint::last_presence_subtype, ast_hint::laststate, and OBJ_UNLINK.

Referenced by ast_add_hint().

{
   struct ast_hint *hint = obj;

   if (hint->callbacks) {
      struct ast_state_cb *state_cb;
      const char *context_name;
      const char *exten_name;

      if (hint->exten) {
         context_name = ast_get_context_name(ast_get_extension_context(hint->exten));
         exten_name = ast_get_extension_name(hint->exten);
         hint->exten = NULL;
      } else {
         /* The extension has already been destroyed */
         context_name = hint->context_name;
         exten_name = hint->exten_name;
      }
      hint->laststate = AST_EXTENSION_DEACTIVATED;
      while ((state_cb = ao2_callback(hint->callbacks, OBJ_UNLINK, NULL, NULL))) {
         /* Notify with -1 and remove all callbacks */
         execute_state_callback(state_cb->change_cb,
            context_name,
            exten_name,
            state_cb->data,
            AST_HINT_UPDATE_DEVICE,
            hint,
            NULL);
         ao2_ref(state_cb, -1);
      }
      ao2_ref(hint->callbacks, -1);
   }
   ast_free(hint->last_presence_subtype);
   ast_free(hint->last_presence_message);
}

static void destroy_pattern_tree

(

struct match_char *

pattern_tree

)

[static]

Definition at line 2441 of file pbx.c.

References match_char::alt_char, ast_free, match_char::exten, and match_char::next_char.

Referenced by __ast_internal_context_destroy().

{
   /* destroy all the alternates */
   if (pattern_tree->alt_char) {
      destroy_pattern_tree(pattern_tree->alt_char);
      pattern_tree->alt_char = 0;
   }
   /* destroy all the nexts */
   if (pattern_tree->next_char) {
      destroy_pattern_tree(pattern_tree->next_char);
      pattern_tree->next_char = 0;
   }
   pattern_tree->exten = 0; /* never hurts to make sure there's no pointers laying around */
   ast_free(pattern_tree);
}

static void destroy_state_cb

(

void *

doomed

)

[static]

Definition at line 5594 of file pbx.c.

References ast_state_cb::data, ast_state_cb::destroy_cb, and ast_state_cb::id.

Referenced by extension_state_add_destroy().

{
   struct ast_state_cb *state_cb = doomed;

   if (state_cb->destroy_cb) {
      state_cb->destroy_cb(state_cb->id, state_cb->data);
   }
}

static void device_state_cb	(	const struct ast_event *	event,
		void *	unused
	)		[static]

Definition at line 11917 of file pbx.c.

References ast_calloc, ast_event_get_ie_str(), AST_EVENT_IE_DEVICE, ast_free, ast_log(), ast_strlen_zero(), ast_taskprocessor_push(), statechange::dev, handle_statechange(), and LOG_ERROR.

Referenced by load_pbx().

{
   const char *device;
   struct statechange *sc;

   device = ast_event_get_ie_str(event, AST_EVENT_IE_DEVICE);
   if (ast_strlen_zero(device)) {
      ast_log(LOG_ERROR, "Received invalid event that had no device IE\n");
      return;
   }

   if (!(sc = ast_calloc(1, sizeof(*sc) + strlen(device) + 1)))
      return;
   strcpy(sc->dev, device);
   if (ast_taskprocessor_push(extension_state_tps, handle_statechange, sc) < 0) {
      ast_free(sc);
   }
}

static void device_state_info_dt

(

void *

obj

)

[static]

Definition at line 5037 of file pbx.c.

References ao2_cleanup, and ast_device_state_info::causing_channel.

Referenced by ast_extension_state3().

{
   struct ast_device_state_info *info = obj;

   ao2_cleanup(info->causing_channel);
}

static void exception_store_free

(

void *

data

)

[static]

Definition at line 3688 of file pbx.c.

References ast_free, ast_string_field_free_memory, and ast_sw::data.

{
   struct pbx_exception *exception = data;
   ast_string_field_free_memory(exception);
   ast_free(exception);
}

static int execute_state_callback	(	ast_state_cb_type	cb,
		const char *	context,
		const char *	exten,
		void *	data,
		enum ast_state_cb_update_reason	reason,
		struct ast_hint *	hint,
		struct ao2_container *	device_state_info
	)		[static]

Definition at line 5208 of file pbx.c.

References ao2_lock, ao2_unlock, AST_EXTENSION_REMOVED, ast_strlen_zero(), ast_state_cb_info::device_state_info, ast_state_cb_info::exten_state, ast_hint::last_presence_message, ast_hint::last_presence_state, ast_hint::last_presence_subtype, ast_hint::laststate, ast_state_cb_info::presence_message, ast_state_cb_info::presence_state, ast_state_cb_info::presence_subtype, and ast_state_cb_info::reason.

Referenced by ast_merge_contexts_and_delete(), destroy_hint(), handle_presencechange(), and handle_statechange().

{
   int res = 0;
   struct ast_state_cb_info info = { 0, };

   info.reason = reason;

   /* Copy over current hint data */
   if (hint) {
      ao2_lock(hint);
      info.exten_state = hint->laststate;
      info.device_state_info = device_state_info;
      info.presence_state = hint->last_presence_state;
      if (!(ast_strlen_zero(hint->last_presence_subtype))) {
         info.presence_subtype = ast_strdupa(hint->last_presence_subtype);
      } else {
         info.presence_subtype = "";
      }
      if (!(ast_strlen_zero(hint->last_presence_message))) {
         info.presence_message = ast_strdupa(hint->last_presence_message);
      } else {
         info.presence_message = "";
      }
      ao2_unlock(hint);
   } else {
      info.exten_state = AST_EXTENSION_REMOVED;
   }

   /* NOTE: The casts will not be needed for v10 and later */
   res = cb((char *) context, (char *) exten, &info, data);

   return res;
}

static int ext_cmp	(	const char *	left,
		const char *	right
	)		[static]

Definition at line 2788 of file pbx.c.

References ext_cmp_exten(), and ext_cmp_pattern().

Referenced by ast_add_extension2_lockopt(), and ast_extension_cmp().

{
   /* Make sure non-pattern extens come first. */
   if (left[0] != '_') {
      if (right[0] == '_') {
         return -1;
      }
      /* Compare two non-pattern extens. */
      return ext_cmp_exten(left, right);
   }
   if (right[0] != '_') {
      return 1;
   }

   /*
    * OK, we need full pattern sorting routine.
    *
    * Skip past the underscores
    */
   return ext_cmp_pattern(left + 1, right + 1);
}

static int ext_cmp_exten	(	const char *	left,
		const char *	right
	)		[static]

Definition at line 2538 of file pbx.c.

Referenced by _extension_match_core(), and ext_cmp().

{
   int cmp;

   for (;;) {
      /* Ignore '-' chars as eye candy fluff. */
      while (*left == '-') {
         ++left;
      }
      while (*right == '-') {
         ++right;
      }

      cmp = *left - *right;
      if (cmp) {
         break;
      }
      if (!*left) {
         /*
          * Get here only if both strings ended at the same time.  cmp
          * would be non-zero if only one string ended.
          */
         break;
      }
      ++left;
      ++right;
   }
   return cmp;
}

static int ext_cmp_exten_partial	(	const char *	left,
		const char *	right
	)		[static]

Definition at line 2495 of file pbx.c.

Referenced by _extension_match_core().

{
   int cmp;

   for (;;) {
      /* Ignore '-' chars as eye candy fluff. */
      while (*left == '-') {
         ++left;
      }
      while (*right == '-') {
         ++right;
      }

      if (!*right) {
         /*
          * Right ended first for partial match or both ended at the same
          * time for a match.
          */
         cmp = 0;
         break;
      }

      cmp = *left - *right;
      if (cmp) {
         break;
      }
      ++left;
      ++right;
   }
   return cmp;
}

static int ext_cmp_exten_strlen

(

const char *

str

)

[static]

Definition at line 2465 of file pbx.c.

References len(), and str.

Referenced by _extension_match_core().

{
   int len;

   len = 0;
   for (;;) {
      /* Ignore '-' chars as eye candy fluff. */
      while (*str == '-') {
         ++str;
      }
      if (!*str) {
         break;
      }
      ++str;
      ++len;
   }
   return len;
}

static int ext_cmp_pattern	(	const char *	left,
		const char *	right
	)		[static]

Definition at line 2740 of file pbx.c.

References ARRAY_LEN, and ext_cmp_pattern_pos().

Referenced by _extension_match_core(), and ext_cmp().

{
   int cmp;
   int left_pos;
   int right_pos;

   for (;;) {
      unsigned char left_bitwise[32] = { 0, };
      unsigned char right_bitwise[32] = { 0, };

      left_pos = ext_cmp_pattern_pos(&left, left_bitwise);
      right_pos = ext_cmp_pattern_pos(&right, right_bitwise);
      cmp = left_pos - right_pos;
      if (!cmp) {
         /*
          * Are the character sets different, even though they score the same?
          *
          * Note: Must swap left and right to get the sense of the
          * comparison correct.  Otherwise, we would need to multiply by
          * -1 instead.
          */
         cmp = memcmp(right_bitwise, left_bitwise, ARRAY_LEN(left_bitwise));
      }
      if (cmp) {
         break;
      }
      if (!left) {
         /*
          * Get here only if both patterns ended at the same time.  cmp
          * would be non-zero if only one pattern ended.
          */
         break;
      }
   }
   return cmp;
}

static int ext_cmp_pattern_pos	(	const char **	p,
		unsigned char *	bitwise
	)		[static]

helper functions to sort extension patterns in the desired way, so that more specific patterns appear first.

The function compares individual characters (or sets of), returning an int where bits 0-7 are the ASCII code of the first char in the set, bits 8-15 are the number of characters in the set, and bits 16-20 are for special cases. This way more specific patterns (smaller character sets) appear first. Wildcards have a special value, so that we can directly compare them to sets by subtracting the two values. In particular: 0x001xx one character, character set starting with xx 0x0yyxx yy characters, character set starting with xx 0x18000 '.' (one or more of anything) 0x28000 '!' (zero or more of anything) 0x30000 NUL (end of string) 0x40000 error in set. The pointer to the string is advanced according to needs. NOTES: 1. the empty set is ignored. 2. given that a full set has always 0 as the first element, we could encode the special cases as 0xffXX where XX is 1, 2, 3, 4 as used above.

Definition at line 2625 of file pbx.c.

References ast_log(), BITS_PER, and LOG_WARNING.

Referenced by ext_cmp_pattern().

{
#define BITS_PER  8  /* Number of bits per unit (byte). */
   unsigned char c;
   unsigned char cmin;
   int count;
   const char *end;

   do {
      /* Get character and advance. (Ignore '-' chars as eye candy fluff.) */
      do {
         c = *(*p)++;
      } while (c == '-');

      /* always return unless we have a set of chars */
      switch (c) {
      default:
         /* ordinary character */
         bitwise[c / BITS_PER] = 1 << ((BITS_PER - 1) - (c % BITS_PER));
         return 0x0100 | c;

      case 'n':
      case 'N':
         /* 2..9 */
         bitwise[6] = 0x3f;
         bitwise[7] = 0xc0;
         return 0x0800 | '2';

      case 'x':
      case 'X':
         /* 0..9 */
         bitwise[6] = 0xff;
         bitwise[7] = 0xc0;
         return 0x0A00 | '0';

      case 'z':
      case 'Z':
         /* 1..9 */
         bitwise[6] = 0x7f;
         bitwise[7] = 0xc0;
         return 0x0900 | '1';

      case '.':
         /* wildcard */
         return 0x18000;

      case '!':
         /* earlymatch */
         return 0x28000;   /* less specific than '.' */

      case '\0':
         /* empty string */
         *p = NULL;
         return 0x30000;

      case '[':
         /* char set */
         break;
      }
      /* locate end of set */
      end = strchr(*p, ']');

      if (!end) {
         ast_log(LOG_WARNING, "Wrong usage of [] in the extension\n");
         return 0x40000;   /* XXX make this entry go last... */
      }

      count = 0;
      cmin = 0xFF;
      for (; *p < end; ++*p) {
         unsigned char c1; /* first char in range */
         unsigned char c2; /* last char in range */

         c1 = (*p)[0];
         if (*p + 2 < end && (*p)[1] == '-') { /* this is a range */
            c2 = (*p)[2];
            *p += 2;    /* skip a total of 3 chars */
         } else {        /* individual character */
            c2 = c1;
         }
         if (c1 < cmin) {
            cmin = c1;
         }
         for (; c1 <= c2; ++c1) {
            unsigned char mask = 1 << ((BITS_PER - 1) - (c1 % BITS_PER));

            /*
             * Note: If two character sets score the same, the one with the
             * lowest ASCII values will compare as coming first.  Must fill
             * in most significant bits for lower ASCII values to accomplish
             * the desired sort order.
             */
            if (!(bitwise[c1 / BITS_PER] & mask)) {
               /* Add the character to the set. */
               bitwise[c1 / BITS_PER] |= mask;
               count += 0x100;
            }
         }
      }
      ++*p;
   } while (!count);/* While the char set was empty. */
   return count | cmin;
}

static int ext_strncpy	(	char *	dst,
		const char *	src,
		int	len
	)		[static]

copy a string skipping whitespace

Definition at line 9800 of file pbx.c.

Referenced by ast_add_extension2_lockopt().

{
   int count = 0;
   int insquares = 0;

   while (*src && (count < len - 1)) {
      if (*src == '[') {
         insquares = 1;
      } else if (*src == ']') {
         insquares = 0;
      } else if (*src == ' ' && !insquares) {
         src++;
         continue;
      }
      *dst = *src;
      dst++;
      src++;
      count++;
   }
   *dst = '\0';

   return count;
}

static int extension_match_core	(	const char *	pattern,
		const char *	data,
		enum ext_match_t	mode
	)		[static]

Definition at line 3027 of file pbx.c.

References _extension_match_core(), ast_add_profile(), ast_mark(), and ast_strlen_zero().

Referenced by ast_extension_close(), ast_extension_match(), and pbx_find_extension().

{
   int i;
   static int prof_id = -2;   /* marker for 'unallocated' id */
   if (prof_id == -2) {
      prof_id = ast_add_profile("ext_match", 0);
   }
   ast_mark(prof_id, 1);
   i = _extension_match_core(ast_strlen_zero(pattern) ? "" : pattern, ast_strlen_zero(data) ? "" : data, mode);
   ast_mark(prof_id, 0);
   return i;
}

static int extension_presence_state_helper	(	struct ast_exten *	e,
		char **	subtype,
		char **	message
	)		[static]

Definition at line 5160 of file pbx.c.

References app, ast_get_extension_app(), ast_str_set(), ast_str_thread_get(), ast_strlen_zero(), extensionstate_buf, and parse_hint_presence().

Referenced by ast_add_hint(), and ast_hint_presence_state().

{
   struct ast_str *hint_app = ast_str_thread_get(&extensionstate_buf, 32);
   char *presence_provider;
   const char *app;

   if (!e || !hint_app) {
      return -1;
   }

   app = ast_get_extension_app(e);
   if (ast_strlen_zero(app)) {
      return -1;
   }

   ast_str_set(&hint_app, 0, "%s", app);
   presence_provider = parse_hint_presence(hint_app);

   if (ast_strlen_zero(presence_provider)) {
      /* No presence string in the hint */
      return 0;
   }

   return ast_presence_state(presence_provider, subtype, message);
}

static int 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,
		int	extended
	)		[static]

Definition at line 5604 of file pbx.c.

References ao2_alloc, ao2_find, ao2_link, ao2_lock, ao2_ref, ao2_unlock, ast_exten::app, ast_add_extension(), ast_free_ptr(), ast_hint_extension(), ast_strdup, ast_hint::callbacks, ast_state_cb::change_cb, ast_exten::cidmatch, ast_exten::data, ast_sw::data, ast_state_cb::data, ast_state_cb::destroy_cb, destroy_state_cb(), ast_exten::exten, ast_state_cb::extended, ast_state_cb::id, id, ast_exten::label, ast_exten::matchcid, ast_context::name, OBJ_NODATA, OBJ_UNLINK, ast_exten::parent, ast_exten::priority, and ast_exten::registrar.

Referenced by ast_extension_state_add(), ast_extension_state_add_destroy(), ast_extension_state_add_destroy_extended(), and ast_extension_state_add_extended().

{
   struct ast_hint *hint;
   struct ast_state_cb *state_cb;
   struct ast_exten *e;
   int id;

   /* If there's no context and extension:  add callback to statecbs list */
   if (!context && !exten) {
      /* Prevent multiple adds from adding the same change_cb at the same time. */
      ao2_lock(statecbs);

      /* Remove any existing change_cb. */
      ao2_find(statecbs, change_cb, OBJ_UNLINK | OBJ_NODATA);

      /* Now insert the change_cb */
      if (!(state_cb = ao2_alloc(sizeof(*state_cb), destroy_state_cb))) {
         ao2_unlock(statecbs);
         return -1;
      }
      state_cb->id = 0;
      state_cb->change_cb = change_cb;
      state_cb->destroy_cb = destroy_cb;
      state_cb->data = data;
      state_cb->extended = extended;
      ao2_link(statecbs, state_cb);

      ao2_ref(state_cb, -1);
      ao2_unlock(statecbs);
      return 0;
   }

   if (!context || !exten)
      return -1;

   /* This callback type is for only one hint, so get the hint */
   e = ast_hint_extension(NULL, context, exten);
   if (!e) {
      return -1;
   }

   /* 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 (e->exten[0] == '_') {
      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);
      e = ast_hint_extension(NULL, context, exten);
      if (!e || e->exten[0] == '_') {
         return -1;
      }
   }

   /* Find the hint in the hints container */
   ao2_lock(hints);/* Locked to hold off ast_merge_contexts_and_delete */
   hint = ao2_find(hints, e, 0);
   if (!hint) {
      ao2_unlock(hints);
      return -1;
   }

   /* Now insert the callback in the callback list  */
   if (!(state_cb = ao2_alloc(sizeof(*state_cb), destroy_state_cb))) {
      ao2_ref(hint, -1);
      ao2_unlock(hints);
      return -1;
   }
   do {
      id = stateid++;      /* Unique ID for this callback */
      /* Do not allow id to ever be -1 or 0. */
   } while (id == -1 || id == 0);
   state_cb->id = id;
   state_cb->change_cb = change_cb; /* Pointer to callback routine */
   state_cb->destroy_cb = destroy_cb;
   state_cb->data = data;     /* Data for the callback */
   state_cb->extended = extended;
   ao2_link(hint->callbacks, state_cb);

   ao2_ref(state_cb, -1);
   ao2_ref(hint, -1);
   ao2_unlock(hints);

   return id;
}

static struct ast_context * find_context

(

const char *

context

)

[static, read]

lookup for a context with a given name,

Return values:

found

context or NULL if not found.

Definition at line 6936 of file pbx.c.

References ast_copy_string(), ast_hashtab_lookup(), and fake_context::name.

{
   struct fake_context item;

   ast_copy_string(item.name, context, sizeof(item.name));

   return ast_hashtab_lookup(contexts_table, &item);
}

static struct ast_context * find_context_locked

(

const char *

context

)

[static, read]

lookup for a context with a given name,

Return values:

with	conlock held if found.
NULL	if not found.

Definition at line 6950 of file pbx.c.

References ast_copy_string(), ast_hashtab_lookup(), ast_rdlock_contexts(), ast_unlock_contexts(), and fake_context::name.

Referenced by ast_add_extension(), ast_context_add_ignorepat(), ast_context_add_include(), ast_context_add_switch(), ast_context_lockmacro(), ast_context_remove_extension_callerid(), ast_context_remove_ignorepat(), ast_context_remove_include(), ast_context_remove_switch(), and ast_context_unlockmacro().

{
   struct ast_context *c;
   struct fake_context item;

   ast_copy_string(item.name, context, sizeof(item.name));

   ast_rdlock_contexts();
   c = ast_hashtab_lookup(contexts_table, &item);
   if (!c) {
      ast_unlock_contexts();
   }

   return c;
}

static int find_hint_by_cb_id	(	void *	obj,
		void *	arg,
		int	flags
	)		[static]

Find Hint by callback id.

Definition at line 5721 of file pbx.c.

References ao2_find, ao2_ref, ast_hint::callbacks, CMP_MATCH, and CMP_STOP.

Referenced by ast_extension_state_del().

{
   struct ast_state_cb *state_cb;
   const struct ast_hint *hint = obj;
   int *id = arg;

   if ((state_cb = ao2_find(hint->callbacks, id, 0))) {
      ao2_ref(state_cb, -1);
      return CMP_MATCH | CMP_STOP;
   }

   return 0;
}

static char* func_args

(

char *

function

)

[static]

return a pointer to the arguments of the function, and terminates the function name with '\0'

Definition at line 4158 of file pbx.c.

References args, ast_log(), and LOG_WARNING.

Referenced by ast_func_read(), ast_func_read2(), and ast_func_write().

{
   char *args = strchr(function, '(');

   if (!args) {
      ast_log(LOG_WARNING, "Function '%s' doesn't contain parentheses.  Assuming null argument.\n", function);
   } else {
      char *p;
      *args++ = '\0';
      if ((p = strrchr(args, ')'))) {
         *p = '\0';
      } else {
         ast_log(LOG_WARNING, "Can't find trailing parenthesis for function '%s(%s'?\n", function, args);
      }
   }
   return args;
}

static struct ast_exten * get_canmatch_exten

(

struct match_char *

node

)

[static, read]

Definition at line 1826 of file pbx.c.

References ast_log(), ast_exten::exten, match_char::exten, LOG_NOTICE, match_char::next_char, and match_char::x.

{
   /* find the exten at the end of the rope */
   struct match_char *node2 = node;

   for (node2 = node; node2; node2 = node2->next_char) {
      if (node2->exten) {
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"CanMatch_exten returns exten %s(%p)\n", node2->exten->exten, node2->exten);
#endif
         return node2->exten;
      }
   }
#ifdef NEED_DEBUG_HERE
   ast_log(LOG_NOTICE,"CanMatch_exten returns NULL, match_char=%s\n", node->x);
#endif
   return 0;
}

static void get_device_state_causing_channels

(

struct ao2_container *

c

)

[static]

/internal /brief Identify a channel for every device which is supposedly responsible for the device state.

Especially when the device is ringing, the oldest ringing channel is chosen. For all other cases the first encountered channel in the specific state is chosen.

Definition at line 5374 of file pbx.c.

References ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_channel_creationtime(), ast_channel_iterator_by_name_new(), ast_channel_iterator_destroy(), ast_channel_iterator_next(), ast_channel_lock, AST_CHANNEL_NAME, ast_channel_ref, ast_channel_unlock, ast_channel_unref, 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_STATE_BUSY, AST_STATE_RINGING, AST_STATE_UP, ast_tvcmp(), ast_device_state_info::causing_channel, ast_device_state_info::device_name, ast_device_state_info::device_state, and match().

Referenced by ast_extension_state_extended(), and handle_statechange().

{
   struct ao2_iterator iter;
   struct ast_device_state_info *info;
   struct ast_channel *chan;

   if (!c || !ao2_container_count(c)) {
      return;
   }
   iter = ao2_iterator_init(c, 0);
   for (; (info = ao2_iterator_next(&iter)); ao2_ref(info, -1)) {
      enum ast_channel_state search_state = 0; /* prevent false uninit warning */
      char match[AST_CHANNEL_NAME];
      struct ast_channel_iterator *chan_iter;
      struct timeval chantime = {0, }; /* prevent false uninit warning */

      switch (info->device_state) {
      case AST_DEVICE_RINGING:
      case AST_DEVICE_RINGINUSE:
         /* find ringing channel */
         search_state = AST_STATE_RINGING;
         break;
      case AST_DEVICE_BUSY:
         /* find busy channel */
         search_state = AST_STATE_BUSY;
         break;
      case AST_DEVICE_ONHOLD:
      case AST_DEVICE_INUSE:
         /* find up channel */
         search_state = AST_STATE_UP;
         break;
      case AST_DEVICE_UNKNOWN:
      case AST_DEVICE_NOT_INUSE:
      case AST_DEVICE_INVALID:
      case AST_DEVICE_UNAVAILABLE:
      case AST_DEVICE_TOTAL /* not a state */:
         /* no channels are of interest */
         continue;
      }

      /* iterate over all channels of the device */
           snprintf(match, sizeof(match), "%s-", info->device_name);
      chan_iter = ast_channel_iterator_by_name_new(match, strlen(match));
      for (; (chan = ast_channel_iterator_next(chan_iter)); ast_channel_unref(chan)) {
         ast_channel_lock(chan);
         /* this channel's state doesn't match */
         if (search_state != ast_channel_state(chan)) {
            ast_channel_unlock(chan);
            continue;
         }
         /* any non-ringing channel will fit */
         if (search_state != AST_STATE_RINGING) {
            ast_channel_unlock(chan);
            info->causing_channel = chan; /* is kept ref'd! */
            break;
         }
         /* but we need the oldest ringing channel of the device to match with undirected pickup */
         if (!info->causing_channel) {
            chantime = ast_channel_creationtime(chan);
            ast_channel_ref(chan); /* must ref it! */
            info->causing_channel = chan;
         } else if (ast_tvcmp(ast_channel_creationtime(chan), chantime) < 0) {
            chantime = ast_channel_creationtime(chan);
            ast_channel_unref(info->causing_channel);
            ast_channel_ref(chan); /* must ref it! */
            info->causing_channel = chan;
         }
         ast_channel_unlock(chan);
      }
      ast_channel_iterator_destroy(chan_iter);
   }
   ao2_iterator_destroy(&iter);
}

static const char* get_pattern_node	(	struct pattern_node *	node,
		const char *	src,
		int	pattern,
		const char *	extenbuf
	)		[static]

Definition at line 2175 of file pbx.c.

References ast_log(), pattern_node::buf, compare_char(), first, INC_DST_OVERFLOW_CHECK, last, LOG_ERROR, LOG_WARNING, and pattern_node::specif.

Referenced by add_exten_to_pattern_tree().

{
#define INC_DST_OVERFLOW_CHECK                     \
   do {                                   \
      if (dst - node->buf < sizeof(node->buf) - 1) {  \
         ++dst;                              \
      } else {                            \
         overflow = 1;                       \
      }                                   \
   } while (0)

   node->specif = 0;
   node->buf[0] = '\0';
   while (*src) {
      if (*src == '[' && pattern) {
         char *dst = node->buf;
         const char *src_next;
         int length;
         int overflow = 0;

         /* get past the '[' */
         ++src;
         for (;;) {
            if (*src == '\\') {
               /* Escaped character. */
               ++src;
               if (*src == '[' || *src == '\\' || *src == '-' || *src == ']') {
                  *dst = *src++;
                  INC_DST_OVERFLOW_CHECK;
               }
            } else if (*src == '-') {
               unsigned char first;
               unsigned char last;

               src_next = src;
               first = *(src_next - 1);
               last = *++src_next;

               if (last == '\\') {
                  /* Escaped character. */
                  last = *++src_next;
               }

               /* Possible char range. */
               if (node->buf[0] && last) {
                  /* Expand the char range. */
                  while (++first <= last) {
                     *dst = first;
                     INC_DST_OVERFLOW_CHECK;
                  }
                  src = src_next + 1;
               } else {
                  /*
                   * There was no left or right char for the range.
                   * It is just a '-'.
                   */
                  *dst = *src++;
                  INC_DST_OVERFLOW_CHECK;
               }
            } else if (*src == '\0') {
               ast_log(LOG_WARNING,
                  "A matching ']' was not found for '[' in exten pattern '%s'\n",
                  extenbuf);
               break;
            } else if (*src == ']') {
               ++src;
               break;
            } else {
               *dst = *src++;
               INC_DST_OVERFLOW_CHECK;
            }
         }
         /* null terminate the exploded range */
         *dst = '\0';

         if (overflow) {
            ast_log(LOG_ERROR,
               "Expanded character set too large to deal with in exten pattern '%s'. Ignoring character set.\n",
               extenbuf);
            node->buf[0] = '\0';
            continue;
         }

         /* Sort the characters in character set. */
         length = strlen(node->buf);
         if (!length) {
            ast_log(LOG_WARNING, "Empty character set in exten pattern '%s'. Ignoring.\n",
               extenbuf);
            node->buf[0] = '\0';
            continue;
         }
         qsort(node->buf, length, 1, compare_char);

         /* Remove duplicate characters from character set. */
         dst = node->buf;
         src_next = node->buf;
         while (*src_next++) {
            if (*dst != *src_next) {
               *++dst = *src_next;
            }
         }

         length = strlen(node->buf);
         length <<= 8;
         node->specif = length | (unsigned char) node->buf[0];
         break;
      } else if (*src == '-') {
         /* Skip dashes in all extensions. */
         ++src;
      } else {
         if (*src == '\\') {
            /*
             * XXX The escape character here does not remove any special
             * meaning to characters except the '[', '\\', and '-'
             * characters since they are special only in this function.
             */
            node->buf[0] = *++src;
            if (!node->buf[0]) {
               break;
            }
         } else {
            node->buf[0] = *src;
            if (pattern) {
               /* make sure n,x,z patterns are canonicalized to N,X,Z */
               if (node->buf[0] == 'n') {
                  node->buf[0] = 'N';
               } else if (node->buf[0] == 'x') {
                  node->buf[0] = 'X';
               } else if (node->buf[0] == 'z') {
                  node->buf[0] = 'Z';
               }
            }
         }
         node->buf[1] = '\0';
         node->specif = 1;
         ++src;
         break;
      }
   }
   return src;

#undef INC_DST_OVERFLOW_CHECK
}

static unsigned get_range	(	char *	src,
		int	max,
		const char *const	names[],
		const char *	msg
	)		[static]

helper function to return a range up to max (7, 12, 31 respectively). names, if supplied, is an array of names that should be mapped to numbers.

Definition at line 9154 of file pbx.c.

References ast_log(), ast_strlen_zero(), LOG_WARNING, and lookup_name().

Referenced by ast_build_timing().

{
   int start, end; /* start and ending position */
   unsigned int mask = 0;
   char *part;

   /* Check for whole range */
   if (ast_strlen_zero(src) || !strcmp(src, "*")) {
      return (1 << max) - 1;
   }

   while ((part = strsep(&src, "&"))) {
      /* Get start and ending position */
      char *endpart = strchr(part, '-');
      if (endpart) {
         *endpart++ = '\0';
      }
      /* Find the start */
      if ((start = lookup_name(part, names, max)) < 0) {
         ast_log(LOG_WARNING, "Invalid %s '%s', skipping element\n", msg, part);
         continue;
      }
      if (endpart) { /* find end of range */
         if ((end = lookup_name(endpart, names, max)) < 0) {
            ast_log(LOG_WARNING, "Invalid end %s '%s', skipping element\n", msg, endpart);
            continue;
         }
      } else {
         end = start;
      }
      /* Fill the mask. Remember that ranges are cyclic */
      mask |= (1 << end);   /* initialize with last element */
      while (start != end) {
         mask |= (1 << start);
         if (++start >= max) {
            start = 0;
         }
      }
   }
   return mask;
}

static void get_timerange	(	struct ast_timing *	i,
		char *	times
	)		[static]

store a bitmask of valid times, one bit each 1 minute

Definition at line 9197 of file pbx.c.

References ast_log(), ast_strlen_zero(), LOG_WARNING, and ast_timing::minmask.

Referenced by ast_build_timing().

{
   char *endpart, *part;
   int x;
   int st_h, st_m;
   int endh, endm;
   int minute_start, minute_end;

   /* start disabling all times, fill the fields with 0's, as they may contain garbage */
   memset(i->minmask, 0, sizeof(i->minmask));

   /* 1-minute per bit */
   /* Star is all times */
   if (ast_strlen_zero(times) || !strcmp(times, "*")) {
      /* 48, because each hour takes 2 integers; 30 bits each */
      for (x = 0; x < 48; x++) {
         i->minmask[x] = 0x3fffffff; /* 30 bits */
      }
      return;
   }
   /* Otherwise expect a range */
   while ((part = strsep(&times, "&"))) {
      if (!(endpart = strchr(part, '-'))) {
         if (sscanf(part, "%2d:%2d", &st_h, &st_m) != 2 || st_h < 0 || st_h > 23 || st_m < 0 || st_m > 59) {
            ast_log(LOG_WARNING, "%s isn't a valid time.\n", part);
            continue;
         }
         i->minmask[st_h * 2 + (st_m >= 30 ? 1 : 0)] |= (1 << (st_m % 30));
         continue;
      }
      *endpart++ = '\0';
      /* why skip non digits? Mostly to skip spaces */
      while (*endpart && !isdigit(*endpart)) {
         endpart++;
      }
      if (!*endpart) {
         ast_log(LOG_WARNING, "Invalid time range starting with '%s-'.\n", part);
         continue;
      }
      if (sscanf(part, "%2d:%2d", &st_h, &st_m) != 2 || st_h < 0 || st_h > 23 || st_m < 0 || st_m > 59) {
         ast_log(LOG_WARNING, "'%s' isn't a valid start time.\n", part);
         continue;
      }
      if (sscanf(endpart, "%2d:%2d", &endh, &endm) != 2 || endh < 0 || endh > 23 || endm < 0 || endm > 59) {
         ast_log(LOG_WARNING, "'%s' isn't a valid end time.\n", endpart);
         continue;
      }
      minute_start = st_h * 60 + st_m;
      minute_end = endh * 60 + endm;
      /* Go through the time and enable each appropriate bit */
      for (x = minute_start; x != minute_end; x = (x + 1) % (24 * 60)) {
         i->minmask[x / 30] |= (1 << (x % 30));
      }
      /* Do the last one */
      i->minmask[x / 30] |= (1 << (x % 30));
   }
   /* All done */
   return;
}

static char* handle_debug_dialplan	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Send ack once.

Definition at line 8146 of file pbx.c.

References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), AST_PBX_MAX_STACK, ast_strlen_zero(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_show_dialplan_context(), dialplan_counters::context_existence, exten, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, ast_cli_args::pos, show_debug_helper(), dialplan_counters::total_context, ast_cli_entry::usage, and ast_cli_args::word.

{
   char *exten = NULL, *context = NULL;
   /* Variables used for different counters */
   struct dialplan_counters counters;
   const char *incstack[AST_PBX_MAX_STACK];

   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan debug";
      e->usage =
         "Usage: dialplan debug [context]\n"
         "       Show dialplan context Trie(s). Usually only useful to folks debugging the deep internals of the fast pattern matcher\n";
      return NULL;
   case CLI_GENERATE:
      return complete_show_dialplan_context(a->line, a->word, a->pos, a->n);
   }

   memset(&counters, 0, sizeof(counters));

   if (a->argc != 2 && a->argc != 3)
      return CLI_SHOWUSAGE;

   /* we obtain [exten@]context? if yes, split them ... */
   /* note: we ignore the exten totally here .... */
   if (a->argc == 3) {
      if (strchr(a->argv[2], '@')) {   /* split into exten & context */
         context = ast_strdupa(a->argv[2]);
         exten = strsep(&context, "@");
         /* change empty strings to NULL */
         if (ast_strlen_zero(exten))
            exten = NULL;
      } else { /* no '@' char, only context given */
         context = ast_strdupa(a->argv[2]);
      }
      if (ast_strlen_zero(context))
         context = NULL;
   }
   /* else Show complete dial plan, context and exten are NULL */
   show_debug_helper(a->fd, context, exten, &counters, NULL, 0, incstack);

   /* check for input failure and throw some error messages */
   if (context && !counters.context_existence) {
      ast_cli(a->fd, "There is no existence of '%s' context\n", context);
      return CLI_FAILURE;
   }


   ast_cli(a->fd,"-= %d %s. =-\n",
         counters.total_context, counters.total_context == 1 ? "context" : "contexts");

   /* everything ok */
   return CLI_SUCCESS;
}

static int handle_presencechange

(

void *

datap

)

[static]

Definition at line 5248 of file pbx.c.

References ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, app, ast_copy_string(), ast_free, ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), AST_HINT_UPDATE_PRESENCE, AST_MAX_CONTEXT, AST_MAX_EXTENSION, ast_mutex_lock, ast_mutex_unlock, ast_str_create(), ast_str_set(), ast_strdup, ast_strlen_zero(), ast_hint::callbacks, ast_state_cb::change_cb, context_merge_lock, ast_state_cb::data, execute_state_callback(), ast_hint::exten, ast_hint::last_presence_message, ast_hint::last_presence_state, ast_hint::last_presence_subtype, presencechange::message, parse(), parse_hint_presence(), presencechange::provider, presencechange::state, and presencechange::subtype.

Referenced by presence_state_cb().

{
   struct ast_hint *hint;
   struct ast_str *hint_app = NULL;
   struct presencechange *pc = datap;
   struct ao2_iterator i;
   struct ao2_iterator cb_iter;
   char context_name[AST_MAX_CONTEXT];
   char exten_name[AST_MAX_EXTENSION];
   int res = -1;

   hint_app = ast_str_create(1024);
   if (!hint_app) {
      goto presencechange_cleanup;
   }

   ast_mutex_lock(&context_merge_lock);/* Hold off ast_merge_contexts_and_delete */
   i = ao2_iterator_init(hints, 0);
   for (; (hint = ao2_iterator_next(&i)); ao2_ref(hint, -1)) {
      struct ast_state_cb *state_cb;
      const char *app;
      char *parse;

      ao2_lock(hint);

      if (!hint->exten) {
         /* The extension has already been destroyed */
         ao2_unlock(hint);
         continue;
      }

      /* Does this hint monitor the device that changed state? */
      app = ast_get_extension_app(hint->exten);
      if (ast_strlen_zero(app)) {
         /* The hint does not monitor presence at all. */
         ao2_unlock(hint);
         continue;
      }

      ast_str_set(&hint_app, 0, "%s", app);
      parse = parse_hint_presence(hint_app);
      if (ast_strlen_zero(parse)) {
         ao2_unlock(hint);
         continue;
      }
      if (strcasecmp(parse, pc->provider)) {
         /* The hint does not monitor the presence provider. */
         ao2_unlock(hint);
         continue;
      }

      /*
       * Save off strings in case the hint extension gets destroyed
       * while we are notifying the watchers.
       */
      ast_copy_string(context_name,
         ast_get_context_name(ast_get_extension_context(hint->exten)),
         sizeof(context_name));
      ast_copy_string(exten_name, ast_get_extension_name(hint->exten),
         sizeof(exten_name));
      ast_str_set(&hint_app, 0, "%s", ast_get_extension_app(hint->exten));

      /* Check to see if update is necessary */
      if ((hint->last_presence_state == pc->state) &&
         ((hint->last_presence_subtype && pc->subtype && !strcmp(hint->last_presence_subtype, pc->subtype)) || (!hint->last_presence_subtype && !pc->subtype)) &&
         ((hint->last_presence_message && pc->message && !strcmp(hint->last_presence_message, pc->message)) || (!hint->last_presence_message && !pc->message))) {

         /* this update is the same as the last, do nothing */
         ao2_unlock(hint);
         continue;
      }

      /* update new values */
      ast_free(hint->last_presence_subtype);
      ast_free(hint->last_presence_message);
      hint->last_presence_state = pc->state;
      hint->last_presence_subtype = pc->subtype ? ast_strdup(pc->subtype) : NULL;
      hint->last_presence_message = pc->message ? ast_strdup(pc->message) : NULL;

      ao2_unlock(hint);

      /* For general callbacks */
      cb_iter = ao2_iterator_init(statecbs, 0);
      for (; (state_cb = ao2_iterator_next(&cb_iter)); ao2_ref(state_cb, -1)) {
         execute_state_callback(state_cb->change_cb,
            context_name,
            exten_name,
            state_cb->data,
            AST_HINT_UPDATE_PRESENCE,
            hint,
            NULL);
      }
      ao2_iterator_destroy(&cb_iter);

      /* For extension callbacks */
      cb_iter = ao2_iterator_init(hint->callbacks, 0);
      for (; (state_cb = ao2_iterator_next(&cb_iter)); ao2_ref(state_cb, -1)) {
         execute_state_callback(state_cb->change_cb,
            context_name,
            exten_name,
            state_cb->data,
            AST_HINT_UPDATE_PRESENCE,
            hint,
            NULL);
      }
      ao2_iterator_destroy(&cb_iter);
   }
   ao2_iterator_destroy(&i);
   ast_mutex_unlock(&context_merge_lock);

   res = 0;

presencechange_cleanup:
   ast_free(hint_app);
   ao2_ref(pc, -1);

   return res;
}

static char* handle_set_chanvar	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 8519 of file pbx.c.

References ast_cli_args::argc, ast_cli_entry::args, ast_cli_args::argv, ast_channel_get_by_name(), ast_channel_unref, ast_cli(), ast_complete_channels(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, pbx_builtin_setvar_helper(), ast_cli_args::pos, ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_channel *chan;
   const char *chan_name, *var_name, *var_value;

   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan set chanvar";
      e->usage =
         "Usage: dialplan set chanvar <channel> <varname> <value>\n"
         "       Set channel variable <varname> to <value>\n";
      return NULL;
   case CLI_GENERATE:
      return ast_complete_channels(a->line, a->word, a->pos, a->n, 3);
   }

   if (a->argc != e->args + 3)
      return CLI_SHOWUSAGE;

   chan_name = a->argv[e->args];
   var_name = a->argv[e->args + 1];
   var_value = a->argv[e->args + 2];

   if (!(chan = ast_channel_get_by_name(chan_name))) {
      ast_cli(a->fd, "Channel '%s' not found\n", chan_name);
      return CLI_FAILURE;
   }

   pbx_builtin_setvar_helper(chan, var_name, var_value);

   chan = ast_channel_unref(chan);

   ast_cli(a->fd, "\n    -- Channel variable '%s' set to '%s' for '%s'\n",  var_name, var_value, chan_name);

   return CLI_SUCCESS;
}

static char* handle_set_extenpatternmatchnew	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 8556 of file pbx.c.

References ast_cli_args::argc, ast_cli(), CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, pbx_set_extenpatternmatchnew(), and ast_cli_entry::usage.

{
   int oldval = 0;

   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan set extenpatternmatchnew true";
      e->usage =
         "Usage: dialplan set extenpatternmatchnew true|false\n"
         "       Use the NEW extension pattern matching algorithm, true or false.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc != 4)
      return CLI_SHOWUSAGE;

   oldval =  pbx_set_extenpatternmatchnew(1);

   if (oldval)
      ast_cli(a->fd, "\n    -- Still using the NEW pattern match algorithm for extension names in the dialplan.\n");
   else
      ast_cli(a->fd, "\n    -- Switched to using the NEW pattern match algorithm for extension names in the dialplan.\n");

   return CLI_SUCCESS;
}

static char* handle_set_global	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 8497 of file pbx.c.

References ast_cli_args::argc, ast_cli_entry::args, ast_cli_args::argv, ast_cli(), CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, pbx_builtin_setvar_helper(), and ast_cli_entry::usage.

{
   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan set global";
      e->usage =
         "Usage: dialplan set global <name> <value>\n"
         "       Set global dialplan variable <name> to <value>\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc != e->args + 2)
      return CLI_SHOWUSAGE;

   pbx_builtin_setvar_helper(NULL, a->argv[3], a->argv[4]);
   ast_cli(a->fd, "\n    -- Global variable '%s' set to '%s'\n", a->argv[3], a->argv[4]);

   return CLI_SUCCESS;
}

static char* handle_show_application	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 7508 of file pbx.c.

References app, ast_cli_args::argc, ast_cli_args::argv, ast_cli(), ast_complete_applications(), AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, print_app_docs(), ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_app *aa;
   int app, no_registered_app = 1;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show application";
      e->usage =
         "Usage: core show application <application> [<application> [<application> [...]]]\n"
         "       Describes a particular application.\n";
      return NULL;
   case CLI_GENERATE:
      /*
       * There is a possibility to show informations about more than one
       * application at one time. You can type 'show application Dial Echo' and
       * you will see informations about these two applications ...
       */
      return ast_complete_applications(a->line, a->word, a->n);
   }

   if (a->argc < 4) {
      return CLI_SHOWUSAGE;
   }

   AST_RWLIST_RDLOCK(&apps);
   AST_RWLIST_TRAVERSE(&apps, aa, list) {
      /* Check for each app that was supplied as an argument */
      for (app = 3; app < a->argc; app++) {
         if (strcasecmp(aa->name, a->argv[app])) {
            continue;
         }

         /* We found it! */
         no_registered_app = 0;

         print_app_docs(aa, a->fd);
      }
   }
   AST_RWLIST_UNLOCK(&apps);

   /* we found at least one app? no? */
   if (no_registered_app) {
      ast_cli(a->fd, "Your application(s) is (are) not registered\n");
      return CLI_FAILURE;
   }

   return CLI_SUCCESS;
}

static char* handle_show_applications	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 7733 of file pbx.c.

References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), ast_cli_complete(), AST_RWLIST_EMPTY, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, ast_app::description, ast_cli_args::fd, ast_cli_args::n, ast_cli_args::pos, ast_app::synopsis, ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_app *aa;
   int like = 0, describing = 0;
   int total_match = 0;    /* Number of matches in like clause */
   int total_apps = 0;     /* Number of apps registered */
   static const char * const choices[] = { "like", "describing", NULL };

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show applications [like|describing]";
      e->usage =
         "Usage: core show applications [{like|describing} <text>]\n"
         "       List applications which are currently available.\n"
         "       If 'like', <text> will be a substring of the app name\n"
         "       If 'describing', <text> will be a substring of the description\n";
      return NULL;
   case CLI_GENERATE:
      return (a->pos != 3) ? NULL : ast_cli_complete(a->word, choices, a->n);
   }

   AST_RWLIST_RDLOCK(&apps);

   if (AST_RWLIST_EMPTY(&apps)) {
      ast_cli(a->fd, "There are no registered applications\n");
      AST_RWLIST_UNLOCK(&apps);
      return CLI_SUCCESS;
   }

   /* core list applications like <keyword> */
   if ((a->argc == 5) && (!strcmp(a->argv[3], "like"))) {
      like = 1;
   } else if ((a->argc > 4) && (!strcmp(a->argv[3], "describing"))) {
      describing = 1;
   }

   /* core list applications describing <keyword1> [<keyword2>] [...] */
   if ((!like) && (!describing)) {
      ast_cli(a->fd, "    -= Registered Asterisk Applications =-\n");
   } else {
      ast_cli(a->fd, "    -= Matching Asterisk Applications =-\n");
   }

   AST_RWLIST_TRAVERSE(&apps, aa, list) {
      int printapp = 0;
      total_apps++;
      if (like) {
         if (strcasestr(aa->name, a->argv[4])) {
            printapp = 1;
            total_match++;
         }
      } else if (describing) {
         if (aa->description) {
            /* Match all words on command line */
            int i;
            printapp = 1;
            for (i = 4; i < a->argc; i++) {
               if (!strcasestr(aa->description, a->argv[i])) {
                  printapp = 0;
               } else {
                  total_match++;
               }
            }
         }
      } else {
         printapp = 1;
      }

      if (printapp) {
         ast_cli(a->fd,"  %20s: %s\n", aa->name, aa->synopsis ? aa->synopsis : "<Synopsis not available>");
      }
   }
   if ((!like) && (!describing)) {
      ast_cli(a->fd, "    -= %d Applications Registered =-\n",total_apps);
   } else {
      ast_cli(a->fd, "    -= %d Applications Matching =-\n",total_match);
   }

   AST_RWLIST_UNLOCK(&apps);

   return CLI_SUCCESS;
}

static char* handle_show_chanvar	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

CLI support for listing chanvar's variables in a parseable way.

Definition at line 8462 of file pbx.c.

References ast_cli_args::argc, ast_cli_entry::args, ast_cli_args::argv, ast_channel_get_by_name(), ast_channel_unref, ast_cli(), ast_complete_channels(), ast_str_alloca, ast_str_buffer(), ast_str_strlen(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, pbx_builtin_serialize_variables(), ast_cli_args::pos, ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_channel *chan = NULL;
   struct ast_str *vars = ast_str_alloca(BUFSIZ * 4); /* XXX large because we might have lots of channel vars */

   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan show chanvar";
      e->usage =
         "Usage: dialplan show chanvar <channel>\n"
         "       List current channel variables and their values\n";
      return NULL;
   case CLI_GENERATE:
      return ast_complete_channels(a->line, a->word, a->pos, a->n, 3);
   }

   if (a->argc != e->args + 1)
      return CLI_SHOWUSAGE;

   if (!(chan = ast_channel_get_by_name(a->argv[e->args]))) {
      ast_cli(a->fd, "Channel '%s' not found\n", a->argv[e->args]);
      return CLI_FAILURE;
   }

   pbx_builtin_serialize_variables(chan, &vars);

   if (ast_str_strlen(vars)) {
      ast_cli(a->fd, "\nVariables for channel %s:\n%s\n", a->argv[e->args], ast_str_buffer(vars));
   }

   chan = ast_channel_unref(chan);

   return CLI_SUCCESS;
}

static char* handle_show_dialplan	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 8079 of file pbx.c.

References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), AST_PBX_MAX_STACK, ast_strlen_zero(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_show_dialplan_context(), dialplan_counters::context_existence, exten, dialplan_counters::extension_existence, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, ast_cli_args::pos, show_dialplan_helper(), dialplan_counters::total_context, dialplan_counters::total_exten, dialplan_counters::total_prio, ast_cli_entry::usage, and ast_cli_args::word.

{
   char *exten = NULL, *context = NULL;
   /* Variables used for different counters */
   struct dialplan_counters counters;
   const char *incstack[AST_PBX_MAX_STACK];

   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan show";
      e->usage =
         "Usage: dialplan show [[exten@]context]\n"
         "       Show dialplan\n";
      return NULL;
   case CLI_GENERATE:
      return complete_show_dialplan_context(a->line, a->word, a->pos, a->n);
   }

   memset(&counters, 0, sizeof(counters));

   if (a->argc != 2 && a->argc != 3)
      return CLI_SHOWUSAGE;

   /* we obtain [exten@]context? if yes, split them ... */
   if (a->argc == 3) {
      if (strchr(a->argv[2], '@')) {   /* split into exten & context */
         context = ast_strdupa(a->argv[2]);
         exten = strsep(&context, "@");
         /* change empty strings to NULL */
         if (ast_strlen_zero(exten))
            exten = NULL;
      } else { /* no '@' char, only context given */
         context = ast_strdupa(a->argv[2]);
      }
      if (ast_strlen_zero(context))
         context = NULL;
   }
   /* else Show complete dial plan, context and exten are NULL */
   show_dialplan_helper(a->fd, context, exten, &counters, NULL, 0, incstack);

   /* check for input failure and throw some error messages */
   if (context && !counters.context_existence) {
      ast_cli(a->fd, "There is no existence of '%s' context\n", context);
      return CLI_FAILURE;
   }

   if (exten && !counters.extension_existence) {
      if (context)
         ast_cli(a->fd, "There is no existence of %s@%s extension\n",
            exten, context);
      else
         ast_cli(a->fd,
            "There is no existence of '%s' extension in all contexts\n",
            exten);
      return CLI_FAILURE;
   }

   ast_cli(a->fd,"-= %d %s (%d %s) in %d %s. =-\n",
            counters.total_exten, counters.total_exten == 1 ? "extension" : "extensions",
            counters.total_prio, counters.total_prio == 1 ? "priority" : "priorities",
            counters.total_context, counters.total_context == 1 ? "context" : "contexts");

   /* everything ok */
   return CLI_SUCCESS;
}

static char* handle_show_function	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 3810 of file pbx.c.

References ast_cli_args::argc, ast_custom_function::arguments, ast_cli_args::argv, ast_cli(), ast_custom_function_find(), ast_free, ast_malloc, AST_MAX_APP, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdup, AST_TERM_MAX_ESCAPE_CHARS, AST_XML_DOC, ast_xmldoc_printable(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, COLOR_CYAN, COLOR_MAGENTA, ast_cli_entry::command, ast_custom_function::desc, ast_custom_function::docsrc, ast_cli_args::fd, ast_cli_args::n, ast_custom_function::name, S_OR, ast_custom_function::seealso, ast_custom_function::synopsis, synopsis, ast_custom_function::syntax, term_color(), ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_custom_function *acf;
   /* Maximum number of characters added by terminal coloring is 22 */
   char infotitle[64 + AST_MAX_APP + 22], syntitle[40], destitle[40], argtitle[40], seealsotitle[40];
   char info[64 + AST_MAX_APP], *synopsis = NULL, *description = NULL, *seealso = NULL;
   char stxtitle[40], *syntax = NULL, *arguments = NULL;
   int syntax_size, description_size, synopsis_size, arguments_size, seealso_size;
   char *ret = NULL;
   int which = 0;
   int wordlen;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show function";
      e->usage =
         "Usage: core show function <function>\n"
         "       Describe a particular dialplan function.\n";
      return NULL;
   case CLI_GENERATE:
      wordlen = strlen(a->word);
      /* case-insensitive for convenience in this 'complete' function */
      AST_RWLIST_RDLOCK(&acf_root);
      AST_RWLIST_TRAVERSE(&acf_root, acf, acflist) {
         if (!strncasecmp(a->word, acf->name, wordlen) && ++which > a->n) {
            ret = ast_strdup(acf->name);
            break;
         }
      }
      AST_RWLIST_UNLOCK(&acf_root);

      return ret;
   }

   if (a->argc < 4) {
      return CLI_SHOWUSAGE;
   }

   if (!(acf = ast_custom_function_find(a->argv[3]))) {
      ast_cli(a->fd, "No function by that name registered.\n");
      return CLI_FAILURE;
   }

   syntax_size = strlen(S_OR(acf->syntax, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
   if (!(syntax = ast_malloc(syntax_size))) {
      ast_cli(a->fd, "Memory allocation failure!\n");
      return CLI_FAILURE;
   }

   snprintf(info, sizeof(info), "\n  -= Info about function '%s' =- \n\n", acf->name);
   term_color(infotitle, info, COLOR_MAGENTA, 0, sizeof(infotitle));
   term_color(syntitle, "[Synopsis]\n", COLOR_MAGENTA, 0, 40);
   term_color(destitle, "[Description]\n", COLOR_MAGENTA, 0, 40);
   term_color(stxtitle, "[Syntax]\n", COLOR_MAGENTA, 0, 40);
   term_color(argtitle, "[Arguments]\n", COLOR_MAGENTA, 0, 40);
   term_color(seealsotitle, "[See Also]\n", COLOR_MAGENTA, 0, 40);
   term_color(syntax, S_OR(acf->syntax, "Not available"), COLOR_CYAN, 0, syntax_size);
#ifdef AST_XML_DOCS
   if (acf->docsrc == AST_XML_DOC) {
      arguments = ast_xmldoc_printable(S_OR(acf->arguments, "Not available"), 1);
      synopsis = ast_xmldoc_printable(S_OR(acf->synopsis, "Not available"), 1);
      description = ast_xmldoc_printable(S_OR(acf->desc, "Not available"), 1);
      seealso = ast_xmldoc_printable(S_OR(acf->seealso, "Not available"), 1);
   } else
#endif
   {
      synopsis_size = strlen(S_OR(acf->synopsis, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      synopsis = ast_malloc(synopsis_size);

      description_size = strlen(S_OR(acf->desc, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      description = ast_malloc(description_size);

      arguments_size = strlen(S_OR(acf->arguments, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      arguments = ast_malloc(arguments_size);

      seealso_size = strlen(S_OR(acf->seealso, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      seealso = ast_malloc(seealso_size);

      /* check allocated memory. */
      if (!synopsis || !description || !arguments || !seealso) {
         ast_free(synopsis);
         ast_free(description);
         ast_free(arguments);
         ast_free(seealso);
         ast_free(syntax);
         return CLI_FAILURE;
      }

      term_color(arguments, S_OR(acf->arguments, "Not available"), COLOR_CYAN, 0, arguments_size);
      term_color(synopsis, S_OR(acf->synopsis, "Not available"), COLOR_CYAN, 0, synopsis_size);
      term_color(description, S_OR(acf->desc, "Not available"), COLOR_CYAN, 0, description_size);
      term_color(seealso, S_OR(acf->seealso, "Not available"), COLOR_CYAN, 0, seealso_size);
   }

   ast_cli(a->fd, "%s%s%s\n\n%s%s\n\n%s%s\n\n%s%s\n\n%s%s\n",
         infotitle, syntitle, synopsis, destitle, description,
         stxtitle, syntax, argtitle, arguments, seealsotitle, seealso);

   ast_free(arguments);
   ast_free(synopsis);
   ast_free(description);
   ast_free(seealso);
   ast_free(syntax);

   return CLI_SUCCESS;
}

static char* handle_show_functions	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 3768 of file pbx.c.

References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, ast_custom_function::name, S_OR, ast_custom_function::synopsis, ast_custom_function::syntax, and ast_cli_entry::usage.

{
   struct ast_custom_function *acf;
   int count_acf = 0;
   int like = 0;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show functions [like]";
      e->usage =
         "Usage: core show functions [like <text>]\n"
         "       List builtin functions, optionally only those matching a given string\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc == 5 && (!strcmp(a->argv[3], "like")) ) {
      like = 1;
   } else if (a->argc != 3) {
      return CLI_SHOWUSAGE;
   }

   ast_cli(a->fd, "%s Custom Functions:\n--------------------------------------------------------------------------------\n", like ? "Matching" : "Installed");

   AST_RWLIST_RDLOCK(&acf_root);
   AST_RWLIST_TRAVERSE(&acf_root, acf, acflist) {
      if (!like || strstr(acf->name, a->argv[4])) {
         count_acf++;
         ast_cli(a->fd, "%-20.20s  %-35.35s  %s\n",
            S_OR(acf->name, ""),
            S_OR(acf->syntax, ""),
            S_OR(acf->synopsis, ""));
      }
   }
   AST_RWLIST_UNLOCK(&acf_root);

   ast_cli(a->fd, "%d %scustom functions installed.\n", count_acf, like ? "matching " : "");

   return CLI_SUCCESS;
}

static char* handle_show_globals	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

CLI support for listing global variables in a parseable way.

Definition at line 8404 of file pbx.c.

References ast_cli(), AST_LIST_TRAVERSE, ast_rwlock_rdlock, ast_rwlock_unlock, ast_var_name(), ast_var_value(), CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, ast_var_t::entries, ast_cli_args::fd, globalslock, and ast_cli_entry::usage.

{
   int i = 0;
   struct ast_var_t *newvariable;

   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan show globals";
      e->usage =
         "Usage: dialplan show globals\n"
         "       List current global dialplan variables and their values\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   ast_rwlock_rdlock(&globalslock);
   AST_LIST_TRAVERSE (&globals, newvariable, entries) {
      i++;
      ast_cli(a->fd, "   %s=%s\n", ast_var_name(newvariable), ast_var_value(newvariable));
   }
   ast_rwlock_unlock(&globalslock);
   ast_cli(a->fd, "\n    -- %d variable(s)\n", i);

   return CLI_SUCCESS;
}

static char* handle_show_hangup_all	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 6354 of file pbx.c.

References ast_cli_args::argc, ast_cli_entry::args, ast_channel_iterator_all_new(), ast_channel_iterator_destroy(), ast_channel_iterator_next(), ast_channel_unref, ast_complete_channels(), ast_pbx_hangup_handler_headers(), ast_pbx_hangup_handler_show(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, ast_cli_args::pos, ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_channel_iterator *iter;
   struct ast_channel *chan;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show hanguphandlers all";
      e->usage =
         "Usage: core show hanguphandlers all\n"
         "       Show hangup handlers for all channels.\n";
      return NULL;
   case CLI_GENERATE:
      return ast_complete_channels(a->line, a->word, a->pos, a->n, e->args);
   }

   if (a->argc < 4) {
      return CLI_SHOWUSAGE;
   }

   iter = ast_channel_iterator_all_new();
   if (!iter) {
      return CLI_FAILURE;
   }

   ast_pbx_hangup_handler_headers(a->fd);
   for (; (chan = ast_channel_iterator_next(iter)); ast_channel_unref(chan)) {
      ast_pbx_hangup_handler_show(a->fd, chan);
   }
   ast_channel_iterator_destroy(iter);

   return CLI_SUCCESS;
}

static char* handle_show_hangup_channel	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 6318 of file pbx.c.

References ast_cli_args::argc, ast_cli_entry::args, ast_cli_args::argv, ast_channel_get_by_name(), ast_channel_unref, ast_cli(), ast_complete_channels(), ast_pbx_hangup_handler_headers(), ast_pbx_hangup_handler_show(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, ast_cli_args::pos, ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_channel *chan;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show hanguphandlers";
      e->usage =
         "Usage: core show hanguphandlers <channel>\n"
         "       Show hangup handlers of a specified channel.\n";
      return NULL;
   case CLI_GENERATE:
      return ast_complete_channels(a->line, a->word, a->pos, a->n, e->args);
   }

   if (a->argc < 4) {
      return CLI_SHOWUSAGE;
   }

   chan = ast_channel_get_by_name(a->argv[3]);
   if (!chan) {
      ast_cli(a->fd, "Channel does not exist.\n");
      return CLI_FAILURE;
   }

   ast_pbx_hangup_handler_headers(a->fd);
   ast_pbx_hangup_handler_show(a->fd, chan);

   ast_channel_unref(chan);

   return CLI_SUCCESS;
}

static char* handle_show_hint	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

handle_show_hint: CLI support for listing registered dial plan hint

Definition at line 7645 of file pbx.c.

References ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_cli_args::argc, ast_cli_args::argv, ast_cli(), ast_extension_state2str(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), ast_hint::callbacks, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_core_show_hint(), ast_hint::exten, ast_cli_args::fd, ast_hint::laststate, ast_cli_args::line, ast_cli_args::n, ast_cli_args::pos, ast_cli_entry::usage, and ast_cli_args::word.

{
   struct ast_hint *hint;
   int watchers;
   int num = 0, extenlen;
   struct ao2_iterator i;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show hint";
      e->usage =
         "Usage: core show hint <exten>\n"
         "       List registered hint\n";
      return NULL;
   case CLI_GENERATE:
      return complete_core_show_hint(a->line, a->word, a->pos, a->n);
   }

   if (a->argc < 4)
      return CLI_SHOWUSAGE;

   if (ao2_container_count(hints) == 0) {
      ast_cli(a->fd, "There are no registered dialplan hints\n");
      return CLI_SUCCESS;
   }

   extenlen = strlen(a->argv[3]);
   i = ao2_iterator_init(hints, 0);
   for (; (hint = ao2_iterator_next(&i)); ao2_ref(hint, -1)) {
      ao2_lock(hint);
      if (!hint->exten) {
         /* The extension has already been destroyed */
         ao2_unlock(hint);
         continue;
      }
      if (!strncasecmp(ast_get_extension_name(hint->exten), a->argv[3], extenlen)) {
         watchers = ao2_container_count(hint->callbacks);
         ast_cli(a->fd, "   %20s@%-20.20s: %-20.20s  State:%-15.15s Watchers %2d\n",
            ast_get_extension_name(hint->exten),
            ast_get_context_name(ast_get_extension_context(hint->exten)),
            ast_get_extension_app(hint->exten),
            ast_extension_state2str(hint->laststate), watchers);
         num++;
      }
      ao2_unlock(hint);
   }
   ao2_iterator_destroy(&i);
   if (!num)
      ast_cli(a->fd, "No hints matching extension %s\n", a->argv[3]);
   else
      ast_cli(a->fd, "%d hint%s matching extension %s\n", num, (num!=1 ? "s":""), a->argv[3]);
   return CLI_SUCCESS;
}

static char* handle_show_hints	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

handle_show_hints: CLI support for listing registered dial plan hints

Definition at line 7559 of file pbx.c.

References ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_cli(), ast_extension_state2str(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), ast_hint::callbacks, CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, ast_hint::exten, ast_cli_args::fd, ast_hint::laststate, and ast_cli_entry::usage.

{
   struct ast_hint *hint;
   int num = 0;
   int watchers;
   struct ao2_iterator i;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show hints";
      e->usage =
         "Usage: core show hints\n"
         "       List registered hints\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (ao2_container_count(hints) == 0) {
      ast_cli(a->fd, "There are no registered dialplan hints\n");
      return CLI_SUCCESS;
   }
   /* ... we have hints ... */
   ast_cli(a->fd, "\n    -= Registered Asterisk Dial Plan Hints =-\n");

   i = ao2_iterator_init(hints, 0);
   for (; (hint = ao2_iterator_next(&i)); ao2_ref(hint, -1)) {
      ao2_lock(hint);
      if (!hint->exten) {
         /* The extension has already been destroyed */
         ao2_unlock(hint);
         continue;
      }
      watchers = ao2_container_count(hint->callbacks);
      ast_cli(a->fd, "   %20s@%-20.20s: %-20.20s  State:%-15.15s Watchers %2d\n",
         ast_get_extension_name(hint->exten),
         ast_get_context_name(ast_get_extension_context(hint->exten)),
         ast_get_extension_app(hint->exten),
         ast_extension_state2str(hint->laststate), watchers);
      ao2_unlock(hint);
      num++;
   }
   ao2_iterator_destroy(&i);

   ast_cli(a->fd, "----------------\n");
   ast_cli(a->fd, "- %d hints registered\n", num);
   return CLI_SUCCESS;
}

static char* handle_show_switches	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

handle_show_switches: CLI support for listing registered dial plan switches

Definition at line 7701 of file pbx.c.

References ast_cli(), AST_RWLIST_EMPTY, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, ast_switch::description, ast_cli_args::fd, ast_switch::name, and ast_cli_entry::usage.

{
   struct ast_switch *sw;

   switch (cmd) {
   case CLI_INIT:
      e->command = "core show switches";
      e->usage =
         "Usage: core show switches\n"
         "       List registered switches\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   AST_RWLIST_RDLOCK(&switches);

   if (AST_RWLIST_EMPTY(&switches)) {
      AST_RWLIST_UNLOCK(&switches);
      ast_cli(a->fd, "There are no registered alternative switches\n");
      return CLI_SUCCESS;
   }

   ast_cli(a->fd, "\n    -= Registered Asterisk Alternative Switches =-\n");
   AST_RWLIST_TRAVERSE(&switches, sw, list)
      ast_cli(a->fd, "%s: %s\n", sw->name, sw->description);

   AST_RWLIST_UNLOCK(&switches);

   return CLI_SUCCESS;
}

static int handle_statechange

(

void *

datap

)

[static]

Definition at line 5448 of file pbx.c.

References alloc_device_state_info(), ao2_cleanup, ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_t_callback, ao2_t_ref, ao2_unlock, ast_alloca, ast_copy_string(), AST_EXTENSION_RINGING, ast_extension_state3(), ast_free, ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), AST_HINT_UPDATE_DEVICE, AST_MAX_CONTEXT, AST_MAX_EXTENSION, ast_mutex_lock, ast_mutex_unlock, ast_str_create(), ast_str_set(), ast_hint::callbacks, context_merge_lock, statechange::dev, execute_state_callback(), ast_hint::exten, get_device_state_causing_channels(), ast_hintdevice::hint, ast_hintdevice::hintdevice, hintdevice_cmp_multiple(), ast_hint::laststate, OBJ_MULTIPLE, OBJ_POINTER, and state.

Referenced by device_state_cb().

{
   struct ast_hint *hint;
   struct ast_str *hint_app;
   struct ast_hintdevice *device;
   struct ast_hintdevice *cmpdevice;
   struct statechange *sc = datap;
   struct ao2_iterator *dev_iter;
   struct ao2_iterator cb_iter;
   char context_name[AST_MAX_CONTEXT];
   char exten_name[AST_MAX_EXTENSION];

   if (ao2_container_count(hintdevices) == 0) {
      /* There are no hints monitoring devices. */
      ast_free(sc);
      return 0;
   }

   hint_app = ast_str_create(1024);
   if (!hint_app) {
      ast_free(sc);
      return -1;
   }

   cmpdevice = ast_alloca(sizeof(*cmpdevice) + strlen(sc->dev));
   strcpy(cmpdevice->hintdevice, sc->dev);

   ast_mutex_lock(&context_merge_lock);/* Hold off ast_merge_contexts_and_delete */
   dev_iter = ao2_t_callback(hintdevices,
      OBJ_POINTER | OBJ_MULTIPLE,
      hintdevice_cmp_multiple,
      cmpdevice,
      "find devices in container");
   if (!dev_iter) {
      ast_mutex_unlock(&context_merge_lock);
      ast_free(hint_app);
      ast_free(sc);
      return -1;
   }

   for (; (device = ao2_iterator_next(dev_iter)); ao2_t_ref(device, -1, "Next device")) {
      struct ast_state_cb *state_cb;
      int state;
      int same_state;
      struct ao2_container *device_state_info;
      int first_extended_cb_call = 1;

      if (!device->hint) {
         /* Should never happen. */
         continue;
      }
      hint = device->hint;

      ao2_lock(hint);
      if (!hint->exten) {
         /* The extension has already been destroyed */
         ao2_unlock(hint);
         continue;
      }

      /*
       * Save off strings in case the hint extension gets destroyed
       * while we are notifying the watchers.
       */
      ast_copy_string(context_name,
         ast_get_context_name(ast_get_extension_context(hint->exten)),
         sizeof(context_name));
      ast_copy_string(exten_name, ast_get_extension_name(hint->exten),
         sizeof(exten_name));
      ast_str_set(&hint_app, 0, "%s", ast_get_extension_app(hint->exten));
      ao2_unlock(hint);

      /*
       * Get device state for this hint.
       *
       * NOTE: We cannot hold any locks while determining the hint
       * device state or notifying the watchers without causing a
       * deadlock.  (conlock, hints, and hint)
       */
      /* Make a container so state3 can fill it if we wish.
       * If that failed we simply do not provide the extended state info.
       */
      device_state_info = alloc_device_state_info();
      state = ast_extension_state3(hint_app, device_state_info);
      if ((same_state = state == hint->laststate) && (~state & AST_EXTENSION_RINGING)) {
         ao2_cleanup(device_state_info);
         continue;
      }

      /* Device state changed since last check - notify the watchers. */
      hint->laststate = state;   /* record we saw the change */

      /* For general callbacks */
      cb_iter = ao2_iterator_init(statecbs, 0);
      for (; !same_state && (state_cb = ao2_iterator_next(&cb_iter)); ao2_ref(state_cb, -1)) {
         execute_state_callback(state_cb->change_cb,
            context_name,
            exten_name,
            state_cb->data,
            AST_HINT_UPDATE_DEVICE,
            hint,
            NULL);
      }
      ao2_iterator_destroy(&cb_iter);

      /* For extension callbacks */
      /* extended callbacks are called when the state changed or when AST_EVENT_RINGING is
       * included. Normal callbacks are only called when the state changed.
       */
      cb_iter = ao2_iterator_init(hint->callbacks, 0);
      for (; (state_cb = ao2_iterator_next(&cb_iter)); ao2_ref(state_cb, -1)) {
         if (state_cb->extended && first_extended_cb_call) {
            /* Fill detailed device_state_info now that we know it is used by extd. callback */
            first_extended_cb_call = 0;
            get_device_state_causing_channels(device_state_info);
         }
         if (state_cb->extended || !same_state) {
            execute_state_callback(state_cb->change_cb,
               context_name,
               exten_name,
               state_cb->data,
               AST_HINT_UPDATE_DEVICE,
               hint,
               state_cb->extended ? device_state_info : NULL);
         }
      }
      ao2_iterator_destroy(&cb_iter);

      ao2_cleanup(device_state_info);
   }
   ast_mutex_unlock(&context_merge_lock);

   ao2_iterator_destroy(dev_iter);
   ast_free(hint_app);
   ast_free(sc);
   return 0;
}

static char* handle_unset_extenpatternmatchnew	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		[static]

Definition at line 8584 of file pbx.c.

References ast_cli_args::argc, ast_cli(), CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, pbx_set_extenpatternmatchnew(), and ast_cli_entry::usage.

{
   int oldval = 0;

   switch (cmd) {
   case CLI_INIT:
      e->command = "dialplan set extenpatternmatchnew false";
      e->usage =
         "Usage: dialplan set extenpatternmatchnew true|false\n"
         "       Use the NEW extension pattern matching algorithm, true or false.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc != 4)
      return CLI_SHOWUSAGE;

   oldval =  pbx_set_extenpatternmatchnew(0);

   if (!oldval)
      ast_cli(a->fd, "\n    -- Still using the OLD pattern match algorithm for extension names in the dialplan.\n");
   else
      ast_cli(a->fd, "\n    -- Switched to using the OLD pattern match algorithm for extension names in the dialplan.\n");

   return CLI_SUCCESS;
}

static int hashtab_compare_exten_labels	(	const void *	ah_a,
		const void *	ah_b
	)		[static]

Definition at line 1278 of file pbx.c.

References ast_exten::label, and S_OR.

Referenced by ast_add_extension2_lockopt().

{
   const struct ast_exten *ac = ah_a;
   const struct ast_exten *bc = ah_b;
   return strcmp(S_OR(ac->label, ""), S_OR(bc->label, ""));
}

static int hashtab_compare_exten_numbers	(	const void *	ah_a,
		const void *	ah_b
	)		[static]

Definition at line 1271 of file pbx.c.

References ast_exten::priority.

Referenced by ast_add_extension2_lockopt().

{
   const struct ast_exten *ac = ah_a;
   const struct ast_exten *bc = ah_b;
   return ac->priority != bc->priority;
}

static int hashtab_compare_extens	(	const void *	ha_a,
		const void *	ah_b
	)		[static]

Definition at line 1243 of file pbx.c.

References AST_EXT_MATCHCID_ANY, AST_EXT_MATCHCID_OFF, ast_strlen_zero(), ast_exten::cidmatch, ast_exten::exten, and ast_exten::matchcid.

Referenced by ast_add_extension2_lockopt().

{
   const struct ast_exten *ac = ah_a;
   const struct ast_exten *bc = ah_b;
   int x = strcmp(ac->exten, bc->exten);
   if (x) { /* if exten names are diff, then return */
      return x;
   }

   /* but if they are the same, do the cidmatch values match? */
   /* not sure which side may be using ast_ext_matchcid_types, so check both */
   if (ac->matchcid == AST_EXT_MATCHCID_ANY || bc->matchcid == AST_EXT_MATCHCID_ANY) {
      return 0;
   }
   if (ac->matchcid == AST_EXT_MATCHCID_OFF && bc->matchcid == AST_EXT_MATCHCID_OFF) {
      return 0;
   }
   if (ac->matchcid != bc->matchcid) {
      return 1;
   }
   /* all other cases already disposed of, match now required on callerid string (cidmatch) */
   /* although ast_add_extension2_lockopt() enforces non-zero ptr, caller may not have */
   if (ast_strlen_zero(ac->cidmatch) && ast_strlen_zero(bc->cidmatch)) {
      return 0;
   }
   return strcmp(ac->cidmatch, bc->cidmatch);
}

static unsigned int hashtab_hash_extens

(

const void *

obj

)

[static]

Definition at line 1291 of file pbx.c.

References AST_EXT_MATCHCID_ON, ast_hashtab_hash_string(), ast_exten::cidmatch, ast_exten::exten, and ast_exten::matchcid.

Referenced by ast_add_extension2_lockopt().

{
   const struct ast_exten *ac = obj;
   unsigned int x = ast_hashtab_hash_string(ac->exten);
   unsigned int y = 0;
   if (ac->matchcid == AST_EXT_MATCHCID_ON)
      y = ast_hashtab_hash_string(ac->cidmatch);
   return x+y;
}

static unsigned int hashtab_hash_labels

(

const void *

obj

)

[static]

Definition at line 1307 of file pbx.c.

References ast_hashtab_hash_string(), ast_exten::label, and S_OR.

Referenced by ast_add_extension2_lockopt().

{
   const struct ast_exten *ac = obj;
   return ast_hashtab_hash_string(S_OR(ac->label, ""));
}

static unsigned int hashtab_hash_priority

(

const void *

obj

)

[static]

Definition at line 1301 of file pbx.c.

References ast_hashtab_hash_int(), and ast_exten::priority.

Referenced by ast_add_extension2_lockopt().

{
   const struct ast_exten *ac = obj;
   return ast_hashtab_hash_int(ac->priority);
}

static int hint_cmp	(	void *	obj,
		void *	arg,
		int	flags
	)		[static]

Definition at line 12397 of file pbx.c.

References CMP_MATCH, CMP_STOP, and ast_hint::exten.

Referenced by ast_pbx_init().

{
   const struct ast_hint *hint = obj;
   const struct ast_exten *exten = arg;

   return (hint->exten == exten) ? CMP_MATCH | CMP_STOP : 0;
}

static int hint_hash	(	const void *	obj,
		const int	flags
	)		[static]

Definition at line 12377 of file pbx.c.

References ast_get_extension_name(), ast_str_case_hash(), ast_strlen_zero(), ast_hint::exten, and ast_hint::exten_name.

Referenced by ast_pbx_init().

{
   const struct ast_hint *hint = obj;
   const char *exten_name;
   int res;

   exten_name = ast_get_extension_name(hint->exten);
   if (ast_strlen_zero(exten_name)) {
      /*
       * If the exten or extension name isn't set, return 0 so that
       * the ao2_find() search will start in the first bucket.
       */
      res = 0;
   } else {
      res = ast_str_case_hash(exten_name);
   }

   return res;
}

static int hint_id_cmp	(	void *	obj,
		void *	arg,
		int	flags
	)		[static]

Definition at line 5769 of file pbx.c.

References CMP_MATCH, CMP_STOP, and ast_state_cb::id.

Referenced by ast_add_hint().

{
   const struct ast_state_cb *cb = obj;
   int *id = arg;

   return (cb->id == *id) ? CMP_MATCH | CMP_STOP : 0;
}

static int hintdevice_cmp_multiple	(	void *	obj,
		void *	arg,
		int	flags
	)		[static]

Note:

Devices on hints are not unique so no CMP_STOP is returned Dont use ao2_find against hintdevices container cause there always could be more than one result.

Definition at line 1037 of file pbx.c.

References CMP_MATCH, ext, and ast_hintdevice::hintdevice.

Referenced by ast_pbx_init(), and handle_statechange().

{
   struct ast_hintdevice *ext = obj, *ext2 = arg;

   return !strcasecmp(ext->hintdevice, ext2->hintdevice) ? CMP_MATCH  : 0;
}

static void hintdevice_destroy

(

void *

obj

)

[static]

Definition at line 1074 of file pbx.c.

References ao2_ref, and ast_hintdevice::hint.

Referenced by add_hintdevice().

{
   struct ast_hintdevice *doomed = obj;

   if (doomed->hint) {
      ao2_ref(doomed->hint, -1);
      doomed->hint = NULL;
   }
}

static int hintdevice_hash_cb	(	const void *	obj,
		const int	flags
	)		[static]

Note:

Using the device for hash

Definition at line 1026 of file pbx.c.

References ast_str_case_hash(), ext, and ast_hintdevice::hintdevice.

Referenced by ast_pbx_init().

{
   const struct ast_hintdevice *ext = obj;

   return ast_str_case_hash(ext->hintdevice);
}

static int hintdevice_remove_cb	(	void *	deviceobj,
		void *	arg,
		int	flags
	)		[static]

Definition at line 1048 of file pbx.c.

References CMP_MATCH, and ast_hintdevice::hint.

Referenced by remove_hintdevice().

{
   struct ast_hintdevice *device = deviceobj;
   struct ast_hint *hint = arg;

   return (device->hint == hint) ? CMP_MATCH : 0;
}

static int hints_data_provider_get	(	const struct ast_data_search *	search,
		struct ast_data *	data_root
	)		[static]

Definition at line 11940 of file pbx.c.

References ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_data_add_int(), ast_data_add_node(), ast_data_add_str(), ast_data_remove_node(), ast_data_search_match(), ast_extension_state2str(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), ast_presence_state2str(), ast_hint::callbacks, ast_hint::exten, ast_hint::last_presence_message, ast_hint::last_presence_state, ast_hint::last_presence_subtype, ast_hint::laststate, and S_OR.

{
   struct ast_data *data_hint;
   struct ast_hint *hint;
   int watchers;
   struct ao2_iterator i;

   if (ao2_container_count(hints) == 0) {
      return 0;
   }

   i = ao2_iterator_init(hints, 0);
   for (; (hint = ao2_iterator_next(&i)); ao2_ref(hint, -1)) {
      watchers = ao2_container_count(hint->callbacks);
      data_hint = ast_data_add_node(data_root, "hint");
      if (!data_hint) {
         continue;
      }
      ast_data_add_str(data_hint, "extension", ast_get_extension_name(hint->exten));
      ast_data_add_str(data_hint, "context", ast_get_context_name(ast_get_extension_context(hint->exten)));
      ast_data_add_str(data_hint, "application", ast_get_extension_app(hint->exten));
      ast_data_add_str(data_hint, "state", ast_extension_state2str(hint->laststate));
      ast_data_add_str(data_hint, "presence_state", ast_presence_state2str(hint->last_presence_state));
      ast_data_add_str(data_hint, "presence_subtype", S_OR(hint->last_presence_subtype, ""));
      ast_data_add_str(data_hint, "presence_subtype", S_OR(hint->last_presence_message, ""));
      ast_data_add_int(data_hint, "watchers", watchers);

      if (!ast_data_search_match(search, data_hint)) {
         ast_data_remove_node(data_root, data_hint);
      }
   }
   ao2_iterator_destroy(&i);

   return 0;
}

static int include_valid

(

struct ast_include *

i

)

[inline, static]

Definition at line 1662 of file pbx.c.

References ast_check_timing(), ast_include::hastime, and ast_include::timing.

Referenced by pbx_find_extension().

{
   if (!i->hastime)
      return 1;

   return ast_check_timing(&(i->timing));
}

static int increase_call_count

(

const struct ast_channel *

c

)

[static]

Increase call count for channel.

Return values:

0	on success
non-zero	if a configured limit (maxcalls, maxload, minmemfree) was reached

Definition at line 6755 of file pbx.c.

References ast_channel_name(), ast_log(), ast_mutex_lock, ast_mutex_unlock, LOG_WARNING, maxcalllock, option_maxcalls, option_maxload, and option_minmemfree.

Referenced by ast_pbx_run_args(), and ast_pbx_start().

{
   int failed = 0;
   double curloadavg;
#if defined(HAVE_SYSINFO)
   long curfreemem;
   struct sysinfo sys_info;
#endif

   ast_mutex_lock(&maxcalllock);
   if (option_maxcalls) {
      if (countcalls >= option_maxcalls) {
         ast_log(LOG_WARNING, "Maximum call limit of %d calls exceeded by '%s'!\n", option_maxcalls, ast_channel_name(c));
         failed = -1;
      }
   }
   if (option_maxload) {
      getloadavg(&curloadavg, 1);
      if (curloadavg >= option_maxload) {
         ast_log(LOG_WARNING, "Maximum loadavg limit of %f load exceeded by '%s' (currently %f)!\n", option_maxload, ast_channel_name(c), curloadavg);
         failed = -1;
      }
   }
#if defined(HAVE_SYSINFO)
   if (option_minmemfree) {
      if (!sysinfo(&sys_info)) {
         /* make sure that the free system memory is above the configured low watermark
          * convert the amount of freeram from mem_units to MB */
         curfreemem = sys_info.freeram * sys_info.mem_unit;
         curfreemem /= 1024 * 1024;
         if (curfreemem < option_minmemfree) {
            ast_log(LOG_WARNING, "Available system memory (~%ldMB) is below the configured low watermark (%ldMB)\n", curfreemem, option_minmemfree);
            failed = -1;
         }
      }
   }
#endif

   if (!failed) {
      countcalls++;
      totalcalls++;
   }
   ast_mutex_unlock(&maxcalllock);

   return failed;
}

static void insert_in_next_chars_alt_char_list	(	struct match_char **	parent_ptr,
		struct match_char *	node
	)		[static]

Definition at line 2080 of file pbx.c.

References match_char::alt_char, and match_char::specificity.

Referenced by add_pattern_node().

{
   struct match_char *curr, *lcurr;

   /* insert node into the tree at "current", so the alt_char list from current is
      sorted in increasing value as you go to the leaves */
   if (!(*parent_ptr)) {
      *parent_ptr = node;
      return;
   }

   if ((*parent_ptr)->specificity > node->specificity) {
      /* insert at head */
      node->alt_char = (*parent_ptr);
      *parent_ptr = node;
      return;
   }

   lcurr = *parent_ptr;
   for (curr = (*parent_ptr)->alt_char; curr; curr = curr->alt_char) {
      if (curr->specificity > node->specificity) {
         node->alt_char = curr;
         lcurr->alt_char = node;
         break;
      }
      lcurr = curr;
   }

   if (!curr) {
      lcurr->alt_char = node;
   }

}

static int internal_extension_state_extended	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		struct ao2_container *	device_state_info
	)		[static]

Definition at line 5106 of file pbx.c.

References ast_exten::app, ast_add_extension(), ast_extension_state2(), ast_free_ptr(), ast_hint_extension(), ast_strdup, ast_exten::cidmatch, ast_exten::data, ast_exten::exten, ast_exten::label, ast_exten::matchcid, ast_context::name, ast_exten::parent, ast_exten::priority, and ast_exten::registrar.

Referenced by ast_extension_state(), and ast_extension_state_extended().

{
   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 */
      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);
      if (!(e = ast_hint_extension(c, context, exten))) {
         /* Improbable, but not impossible */
         return -1;
      }
   }

   return ast_extension_state2(e, device_state_info);  /* Check all devices in the hint */
}

static int is_read_allowed

(

struct ast_custom_function *

acfptr

)

[static]

Determines whether execution of a custom function's read function is allowed.

Parameters:

acfptr

Custom function to check

Returns:

True (non-zero) if reading is allowed.

False (zero) if reading is not allowed.

Definition at line 4236 of file pbx.c.

References ast_debug, ast_custom_function::name, read_escalates(), and thread_inhibits_escalations().

Referenced by ast_func_read(), and ast_func_read2().

{
   if (!acfptr) {
      return 1;
   }

   if (!read_escalates(acfptr)) {
      return 1;
   }

   if (!thread_inhibits_escalations()) {
      return 1;
   }

   if (live_dangerously) {
      /* Global setting overrides the thread's preference */
      ast_debug(2, "Reading %s from a dangerous context\n",
         acfptr->name);
      return 1;
   }

   /* We have no reason to allow this function to execute */
   return 0;
}

static int is_write_allowed

(

struct ast_custom_function *

acfptr

)

[static]

Determines whether execution of a custom function's write function is allowed.

Parameters:

acfptr

Custom function to check

Returns:

True (non-zero) if writing is allowed.

False (zero) if writing is not allowed.

Definition at line 4269 of file pbx.c.

References ast_debug, ast_custom_function::name, thread_inhibits_escalations(), and write_escalates().

Referenced by ast_func_write().

{
   if (!acfptr) {
      return 1;
   }

   if (!write_escalates(acfptr)) {
      return 1;
   }

   if (!thread_inhibits_escalations()) {
      return 1;
   }

   if (live_dangerously) {
      /* Global setting overrides the thread's preference */
      ast_debug(2, "Writing %s from a dangerous context\n",
         acfptr->name);
      return 1;
   }

   /* We have no reason to allow this function to execute */
   return 0;
}

int load_pbx

(

void

)

Provided by pbx.c

Definition at line 12013 of file pbx.c.

References __ast_custom_function_register(), ARRAY_LEN, ast_cli_register_multiple(), ast_data_register_multiple_core, AST_EVENT_DEVICE_STATE, AST_EVENT_IE_END, AST_EVENT_PRESENCE_STATE, ast_event_subscribe(), ast_log(), ast_manager_register_xml_core, ast_register_application2(), ast_register_atexit(), ast_taskprocessor_get(), ast_verb, builtins, device_state_cb(), EVENT_FLAG_CONFIG, EVENT_FLAG_REPORTING, exception_function, LOG_ERROR, LOG_WARNING, manager_show_dialplan(), pbx_cli, pbx_data_providers, presence_state_cb(), testtime_function, and unload_pbx().

Referenced by main().

{
   int x;

   ast_register_atexit(unload_pbx);

   /* Initialize the PBX */
   ast_verb(1, "Asterisk PBX Core Initializing\n");
   if (!(extension_state_tps = ast_taskprocessor_get("pbx-core", 0))) {
      ast_log(LOG_WARNING, "failed to create pbx-core taskprocessor\n");
   }

   ast_verb(1, "Registering builtin applications:\n");
   ast_cli_register_multiple(pbx_cli, ARRAY_LEN(pbx_cli));
   ast_data_register_multiple_core(pbx_data_providers, ARRAY_LEN(pbx_data_providers));
   __ast_custom_function_register(&exception_function, NULL);
   __ast_custom_function_register(&testtime_function, NULL);

   /* Register builtin applications */
   for (x = 0; x < ARRAY_LEN(builtins); x++) {
      ast_verb(1, "[%s]\n", builtins[x].name);
      if (ast_register_application2(builtins[x].name, builtins[x].execute, NULL, NULL, NULL)) {
         ast_log(LOG_ERROR, "Unable to register builtin application '%s'\n", builtins[x].name);
         return -1;
      }
   }

   /* Register manager application */
   ast_manager_register_xml_core("ShowDialPlan", EVENT_FLAG_CONFIG | EVENT_FLAG_REPORTING, manager_show_dialplan);

   if (!(device_state_sub = ast_event_subscribe(AST_EVENT_DEVICE_STATE, device_state_cb, "pbx Device State Change", NULL,
         AST_EVENT_IE_END))) {
      return -1;
   }

   if (!(presence_state_sub = ast_event_subscribe(AST_EVENT_PRESENCE_STATE, presence_state_cb, "pbx Presence State Change", NULL,
         AST_EVENT_IE_END))) {
      return -1;
   }

   return 0;
}

static int lookup_name	(	const char *	s,
		const char *const	names[],
		int	max
	)		[static]

Helper for get_range. return the index of the matching entry, starting from 1. If names is not supplied, try numeric values.

Definition at line 9131 of file pbx.c.

Referenced by get_range().

{
   int i;

   if (names && *s > '9') {
      for (i = 0; names[i]; i++) {
         if (!strcasecmp(s, names[i])) {
            return i;
         }
      }
   }

   /* Allow months and weekdays to be specified as numbers, as well */
   if (sscanf(s, "%2d", &i) == 1 && i >= 1 && i <= max) {
      /* What the array offset would have been: "1" would be at offset 0 */
      return i - 1;
   }
   return -1; /* error return */
}

static void manager_dpsendack	(	struct mansession *	s,
		const struct message *	m
	)		[static]

Send ack once.

Definition at line 8202 of file pbx.c.

References astman_send_listack().

Referenced by manager_show_dialplan(), and manager_show_dialplan_helper().

{
   astman_send_listack(s, m, "DialPlan list will follow", "start");
}

static int manager_show_dialplan	(	struct mansession *	s,
		const struct message *	m
	)		[static]

Manager listing of dial plan.

Definition at line 8347 of file pbx.c.

References ast_strlen_zero(), astman_append(), astman_get_header(), astman_send_error(), context, dialplan_counters::context_existence, exten, dialplan_counters::extension_existence, manager_dpsendack(), manager_show_dialplan_helper(), dialplan_counters::total_context, dialplan_counters::total_exten, dialplan_counters::total_items, and dialplan_counters::total_prio.

Referenced by load_pbx().

{
   const char *exten, *context;
   const char *id = astman_get_header(m, "ActionID");
   char idtext[256];

   /* Variables used for different counters */
   struct dialplan_counters counters;

   if (!ast_strlen_zero(id))
      snprintf(idtext, sizeof(idtext), "ActionID: %s\r\n", id);
   else
      idtext[0] = '\0';

   memset(&counters, 0, sizeof(counters));

   exten = astman_get_header(m, "Extension");
   context = astman_get_header(m, "Context");

   manager_show_dialplan_helper(s, m, idtext, context, exten, &counters, NULL);

   if (!ast_strlen_zero(context) && !counters.context_existence) {
      char errorbuf[BUFSIZ];

      snprintf(errorbuf, sizeof(errorbuf), "Did not find context %s", context);
      astman_send_error(s, m, errorbuf);
      return 0;
   }
   if (!ast_strlen_zero(exten) && !counters.extension_existence) {
      char errorbuf[BUFSIZ];

      if (!ast_strlen_zero(context))
         snprintf(errorbuf, sizeof(errorbuf), "Did not find extension %s@%s", exten, context);
      else
         snprintf(errorbuf, sizeof(errorbuf), "Did not find extension %s in any context", exten);
      astman_send_error(s, m, errorbuf);
      return 0;
   }

   if (!counters.total_items) {
      manager_dpsendack(s, m);
   }

   astman_append(s, "Event: ShowDialPlanComplete\r\n"
      "EventList: Complete\r\n"
      "ListItems: %d\r\n"
      "ListExtensions: %d\r\n"
      "ListPriorities: %d\r\n"
      "ListContexts: %d\r\n"
      "%s"
      "\r\n", counters.total_items, counters.total_exten, counters.total_prio, counters.total_context, idtext);

   /* everything ok */
   return 0;
}

static int manager_show_dialplan_helper	(	struct mansession *	s,
		const struct message *	m,
		const char *	actionidtext,
		const char *	context,
		const char *	exten,
		struct dialplan_counters *	dpc,
		struct ast_include *	rinclude
	)		[static]

Show dialplan extensions XXX this function is similar but not exactly the same as the CLI's show dialplan. Must check whether the difference is intentional or not.

Definition at line 8211 of file pbx.c.

References ast_debug, ast_extension_match(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_app_data(), ast_get_extension_label(), ast_get_extension_name(), ast_get_extension_priority(), ast_get_extension_registrar(), ast_get_ignorepat_name(), ast_get_ignorepat_registrar(), ast_get_include_name(), ast_get_include_registrar(), ast_get_switch_data(), ast_get_switch_name(), ast_get_switch_registrar(), ast_log(), AST_MAX_EXTENSION, ast_rdlock_context(), ast_rdlock_contexts(), ast_strlen_zero(), ast_unlock_context(), ast_unlock_contexts(), ast_walk_context_extensions(), ast_walk_context_ignorepats(), ast_walk_context_includes(), ast_walk_context_switches(), ast_walk_contexts(), ast_walk_extension_priorities(), astman_append(), astman_send_error(), dialplan_counters::context_existence, dialplan_counters::extension_existence, LOG_WARNING, manager_dpsendack(), PRIORITY_HINT, dialplan_counters::total_context, dialplan_counters::total_exten, dialplan_counters::total_items, and dialplan_counters::total_prio.

Referenced by manager_show_dialplan().

{
   struct ast_context *c;
   int res = 0, old_total_exten = dpc->total_exten;

   if (ast_strlen_zero(exten))
      exten = NULL;
   if (ast_strlen_zero(context))
      context = NULL;

   ast_debug(3, "manager_show_dialplan: Context: -%s- Extension: -%s-\n", context, exten);

   /* try to lock contexts */
   if (ast_rdlock_contexts()) {
      astman_send_error(s, m, "Failed to lock contexts");
      ast_log(LOG_WARNING, "Failed to lock contexts list for manager: listdialplan\n");
      return -1;
   }

   c = NULL;      /* walk all contexts ... */
   while ( (c = ast_walk_contexts(c)) ) {
      struct ast_exten *e;
      struct ast_include *i;
      struct ast_ignorepat *ip;

      if (context && strcmp(ast_get_context_name(c), context) != 0)
         continue;   /* not the name we want */

      dpc->context_existence = 1;
      dpc->total_context++;

      ast_debug(3, "manager_show_dialplan: Found Context: %s \n", ast_get_context_name(c));

      if (ast_rdlock_context(c)) {  /* failed to lock */
         ast_debug(3, "manager_show_dialplan: Failed to lock context\n");
         continue;
      }

      /* XXX note- an empty context is not printed */
      e = NULL;      /* walk extensions in context  */
      while ( (e = ast_walk_context_extensions(c, e)) ) {
         struct ast_exten *p;

         /* looking for extension? is this our extension? */
         if (exten && !ast_extension_match(ast_get_extension_name(e), exten)) {
            /* not the one we are looking for, continue */
            ast_debug(3, "manager_show_dialplan: Skipping extension %s\n", ast_get_extension_name(e));
            continue;
         }
         ast_debug(3, "manager_show_dialplan: Found Extension: %s \n", ast_get_extension_name(e));

         dpc->extension_existence = 1;

         dpc->total_exten++;

         p = NULL;      /* walk next extension peers */
         while ( (p = ast_walk_extension_priorities(e, p)) ) {
            int prio = ast_get_extension_priority(p);

            dpc->total_prio++;
            if (!dpc->total_items++)
               manager_dpsendack(s, m);
            astman_append(s, "Event: ListDialplan\r\n%s", actionidtext);
            astman_append(s, "Context: %s\r\nExtension: %s\r\n", ast_get_context_name(c), ast_get_extension_name(e) );

            /* XXX maybe make this conditional, if p != e ? */
            if (ast_get_extension_label(p))
               astman_append(s, "ExtensionLabel: %s\r\n", ast_get_extension_label(p));

            if (prio == PRIORITY_HINT) {
               astman_append(s, "Priority: hint\r\nApplication: %s\r\n", ast_get_extension_app(p));
            } else {
               astman_append(s, "Priority: %d\r\nApplication: %s\r\nAppData: %s\r\n", prio, ast_get_extension_app(p), (char *) ast_get_extension_app_data(p));
            }
            astman_append(s, "Registrar: %s\r\n\r\n", ast_get_extension_registrar(e));
         }
      }

      i = NULL;      /* walk included and write info ... */
      while ( (i = ast_walk_context_includes(c, i)) ) {
         if (exten) {
            /* Check all includes for the requested extension */
            manager_show_dialplan_helper(s, m, actionidtext, ast_get_include_name(i), exten, dpc, i);
         } else {
            if (!dpc->total_items++)
               manager_dpsendack(s, m);
            astman_append(s, "Event: ListDialplan\r\n%s", actionidtext);
            astman_append(s, "Context: %s\r\nIncludeContext: %s\r\nRegistrar: %s\r\n", ast_get_context_name(c), ast_get_include_name(i), ast_get_include_registrar(i));
            astman_append(s, "\r\n");
            ast_debug(3, "manager_show_dialplan: Found Included context: %s \n", ast_get_include_name(i));
         }
      }

      ip = NULL;  /* walk ignore patterns and write info ... */
      while ( (ip = ast_walk_context_ignorepats(c, ip)) ) {
         const char *ipname = ast_get_ignorepat_name(ip);
         char ignorepat[AST_MAX_EXTENSION];

         snprintf(ignorepat, sizeof(ignorepat), "_%s.", ipname);
         if (!exten || ast_extension_match(ignorepat, exten)) {
            if (!dpc->total_items++)
               manager_dpsendack(s, m);
            astman_append(s, "Event: ListDialplan\r\n%s", actionidtext);
            astman_append(s, "Context: %s\r\nIgnorePattern: %s\r\nRegistrar: %s\r\n", ast_get_context_name(c), ipname, ast_get_ignorepat_registrar(ip));
            astman_append(s, "\r\n");
         }
      }
      if (!rinclude) {
         struct ast_sw *sw = NULL;
         while ( (sw = ast_walk_context_switches(c, sw)) ) {
            if (!dpc->total_items++)
               manager_dpsendack(s, m);
            astman_append(s, "Event: ListDialplan\r\n%s", actionidtext);
            astman_append(s, "Context: %s\r\nSwitch: %s/%s\r\nRegistrar: %s\r\n", ast_get_context_name(c), ast_get_switch_name(sw), ast_get_switch_data(sw), ast_get_switch_registrar(sw));
            astman_append(s, "\r\n");
            ast_debug(3, "manager_show_dialplan: Found Switch : %s \n", ast_get_switch_name(sw));
         }
      }

      ast_unlock_context(c);
   }
   ast_unlock_contexts();

   if (dpc->total_exten == old_total_exten) {
      ast_debug(3, "manager_show_dialplan: Found nothing new\n");
      /* Nothing new under the sun */
      return -1;
   } else {
      return res;
   }
}

static int matchcid	(	const char *	cidpattern,
		const char *	callerid
	)		[static]

Definition at line 3098 of file pbx.c.

References ast_extension_match(), and ast_strlen_zero().

Referenced by pbx_find_extension().

{
   /* If the Caller*ID pattern is empty, then we're matching NO Caller*ID, so
      failing to get a number should count as a match, otherwise not */

   if (ast_strlen_zero(callerid)) {
      return ast_strlen_zero(cidpattern) ? 1 : 0;
   }

   return ast_extension_match(cidpattern, callerid);
}

static void new_find_extension	(	const char *	str,
		struct scoreboard *	score,
		struct match_char *	tree,
		int	length,
		int	spec,
		const char *	callerid,
		const char *	label,
		enum ext_match_t	action
	)		[static]

Definition at line 1904 of file pbx.c.

References match_char::alt_char, ast_debug, ast_log(), scoreboard::canmatch, match_char::deleted, E_CANMATCH, E_MATCHMORE, ast_exten::exten, match_char::exten, scoreboard::exten, match_char::is_pattern, ast_exten::label, LOG_NOTICE, NEW_MATCHER_CHK_MATCH, NEW_MATCHER_RECURSE, match_char::next_char, match_char::specificity, str, update_scoreboard(), and match_char::x.

Referenced by pbx_find_extension().

{
   struct match_char *p; /* note minimal stack storage requirements */
   struct ast_exten pattern = { .label = label };
#ifdef DEBUG_THIS
   if (tree)
      ast_log(LOG_NOTICE,"new_find_extension called with %s on (sub)tree %s action=%s\n", str, tree->x, action2str(action));
   else
      ast_log(LOG_NOTICE,"new_find_extension called with %s on (sub)tree NULL action=%s\n", str, action2str(action));
#endif
   for (p = tree; p; p = p->alt_char) {
      if (p->is_pattern) {
         if (p->x[0] == 'N') {
            if (p->x[1] == 0 && *str >= '2' && *str <= '9' ) {
#define  NEW_MATCHER_CHK_MATCH          \
               if (p->exten && !(*(str + 1))) { /* if a shorter pattern matches along the way, might as well report it */             \
                  if (action == E_MATCH || action == E_SPAWN || action == E_FINDLABEL) { /* if in CANMATCH/MATCHMORE, don't let matches get in the way */   \
                     update_scoreboard(score, length + 1, spec + p->specificity, p->exten, 0, callerid, p->deleted, p);                 \
                     if (!p->deleted) {                                                                                           \
                        if (action == E_FINDLABEL) {                                                                             \
                           if (ast_hashtab_lookup(score->exten->peer_label_table, &pattern)) {                                  \
                              ast_debug(4, "Found label in preferred extension\n");                                            \
                              return;                                                                                          \
                           }                                                                                                    \
                        } else {                                                                                                 \
                           ast_debug(4, "returning an exact match-- first found-- %s\n", p->exten->exten);                       \
                           return; /* the first match, by definition, will be the best, because of the sorted tree */           \
                        }                                                                                                        \
                     }                                                                                                            \
                  }                                                                                                                \
               }

#define  NEW_MATCHER_RECURSE             \
               if (p->next_char && (*(str + 1) || (p->next_char->x[0] == '/' && p->next_char->x[1] == 0)                 \
                                             || p->next_char->x[0] == '!')) {                                          \
                  if (*(str + 1) || p->next_char->x[0] == '!') {                                                         \
                     new_find_extension(str + 1, score, p->next_char, length + 1, spec + p->specificity, callerid, label, action); \
                     if (score->exten)  {                                                                             \
                          ast_debug(4 ,"returning an exact match-- %s\n", score->exten->exten);                         \
                        return; /* the first match is all we need */                                                 \
                     }                                                                                    \
                  } else {                                                                                             \
                     new_find_extension("/", score, p->next_char, length + 1, spec + p->specificity, callerid, label, action);    \
                     if (score->exten || ((action == E_CANMATCH || action == E_MATCHMORE) && score->canmatch)) {      \
                          ast_debug(4,"returning a (can/more) match--- %s\n", score->exten ? score->exten->exten :     \
                                     "NULL");                                                                        \
                        return; /* the first match is all we need */                                                 \
                     }                                                                                    \
                  }                                                                                                    \
               } else if ((p->next_char || action == E_CANMATCH) && !*(str + 1)) {                                                                  \
                  score->canmatch = 1;                                                                                 \
                  score->canmatch_exten = get_canmatch_exten(p);                                                       \
                  if (action == E_CANMATCH || action == E_MATCHMORE) {                                                 \
                       ast_debug(4, "returning a canmatch/matchmore--- str=%s\n", str);                                  \
                     return;                                                                                          \
                  }                                                                                        \
               }

               NEW_MATCHER_CHK_MATCH;
               NEW_MATCHER_RECURSE;
            }
         } else if (p->x[0] == 'Z') {
            if (p->x[1] == 0 && *str >= '1' && *str <= '9' ) {
               NEW_MATCHER_CHK_MATCH;
               NEW_MATCHER_RECURSE;
            }
         } else if (p->x[0] == 'X') {
            if (p->x[1] == 0 && *str >= '0' && *str <= '9' ) {
               NEW_MATCHER_CHK_MATCH;
               NEW_MATCHER_RECURSE;
            }
         } else if (p->x[0] == '.' && p->x[1] == 0) {
            /* how many chars will the . match against? */
            int i = 0;
            const char *str2 = str;
            while (*str2 && *str2 != '/') {
               str2++;
               i++;
            }
            if (p->exten && *str2 != '/') {
               update_scoreboard(score, length + i, spec + (i * p->specificity), p->exten, '.', callerid, p->deleted, p);
               if (score->exten) {
                  ast_debug(4,"return because scoreboard has a match with '/'--- %s\n", score->exten->exten);
                  return; /* the first match is all we need */
               }
            }
            if (p->next_char && p->next_char->x[0] == '/' && p->next_char->x[1] == 0) {
               new_find_extension("/", score, p->next_char, length + i, spec+(p->specificity*i), callerid, label, action);
               if (score->exten || ((action == E_CANMATCH || action == E_MATCHMORE) && score->canmatch)) {
                  ast_debug(4, "return because scoreboard has exact match OR CANMATCH/MATCHMORE & canmatch set--- %s\n", score->exten ? score->exten->exten : "NULL");
                  return; /* the first match is all we need */
               }
            }
         } else if (p->x[0] == '!' && p->x[1] == 0) {
            /* how many chars will the . match against? */
            int i = 1;
            const char *str2 = str;
            while (*str2 && *str2 != '/') {
               str2++;
               i++;
            }
            if (p->exten && *str2 != '/') {
               update_scoreboard(score, length + 1, spec + (p->specificity * i), p->exten, '!', callerid, p->deleted, p);
               if (score->exten) {
                  ast_debug(4, "return because scoreboard has a '!' match--- %s\n", score->exten->exten);
                  return; /* the first match is all we need */
               }
            }
            if (p->next_char && p->next_char->x[0] == '/' && p->next_char->x[1] == 0) {
               new_find_extension("/", score, p->next_char, length + i, spec + (p->specificity * i), callerid, label, action);
               if (score->exten || ((action == E_CANMATCH || action == E_MATCHMORE) && score->canmatch)) {
                  ast_debug(4, "return because scoreboard has exact match OR CANMATCH/MATCHMORE & canmatch set with '/' and '!'--- %s\n", score->exten ? score->exten->exten : "NULL");
                  return; /* the first match is all we need */
               }
            }
         } else if (p->x[0] == '/' && p->x[1] == 0) {
            /* the pattern in the tree includes the cid match! */
            if (p->next_char && callerid && *callerid) {
               new_find_extension(callerid, score, p->next_char, length + 1, spec, callerid, label, action);
               if (score->exten || ((action == E_CANMATCH || action == E_MATCHMORE) && score->canmatch)) {
                  ast_debug(4, "return because scoreboard has exact match OR CANMATCH/MATCHMORE & canmatch set with '/'--- %s\n", score->exten ? score->exten->exten : "NULL");
                  return; /* the first match is all we need */
               }
            }
         } else if (strchr(p->x, *str)) {
            ast_debug(4, "Nothing strange about this match\n");
            NEW_MATCHER_CHK_MATCH;
            NEW_MATCHER_RECURSE;
         }
      } else if (strchr(p->x, *str)) {
         ast_debug(4, "Nothing strange about this match\n");
         NEW_MATCHER_CHK_MATCH;
         NEW_MATCHER_RECURSE;
      }
   }
   ast_debug(4, "return at end of func\n");
}

static char * parse_hint_device

(

struct ast_str *

hint_args

)

[static]

Definition at line 5024 of file pbx.c.

References ast_str_buffer(), ast_str_set(), and copy().

Referenced by add_hintdevice(), and ast_extension_state3().

{
   char *copy = ast_strdupa(ast_str_buffer(hint_args));
   char *tmp;

   if ((tmp = strrchr(copy, ','))) {
      *tmp = '\0';
   }

   ast_str_set(&hint_args, 0, "%s", copy);
   return ast_str_buffer(hint_args);
}

static char* parse_hint_presence

(

struct ast_str *

hint_args

)

[static]

Definition at line 5005 of file pbx.c.

References ast_str_buffer(), ast_str_set(), and copy().

Referenced by extension_presence_state_helper(), and handle_presencechange().

{
   char *copy = ast_strdupa(ast_str_buffer(hint_args));
   char *tmp = "";

   if ((tmp = strrchr(copy, ','))) {
      *tmp = '\0';
      tmp++;
   } else {
      return NULL;
   }
   ast_str_set(&hint_args, 0, "%s", tmp);
   return ast_str_buffer(hint_args);
}

static int parse_variable_name	(	char *	var,
		int *	offset,
		int *	length,
		int *	isfunc
	)		[static]

extract offset:length from variable name.

Returns:

1 if there is a offset:length part, which is trimmed off (values go into variables)

Definition at line 3408 of file pbx.c.

References var.

Referenced by ast_str_retrieve_variable(), ast_str_substitute_variables_full(), and pbx_substitute_variables_helper_full().

{
   int parens = 0;

   *offset = 0;
   *length = INT_MAX;
   *isfunc = 0;
   for (; *var; var++) {
      if (*var == '(') {
         (*isfunc)++;
         parens++;
      } else if (*var == ')') {
         parens--;
      } else if (*var == ':' && parens == 0) {
         *var++ = '\0';
         sscanf(var, "%30d:%30d", offset, length);
         return 1; /* offset:length valid */
      }
   }
   return 0;
}

void pbx_builtin_clear_globals

(

void

)

Definition at line 11771 of file pbx.c.

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

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

{
   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);
}

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 11532 of file pbx.c.

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(), and globalslock.

Referenced by __ast_pbx_run(), _macro_exec(), _while_exec(), agentmonitoroutgoing_exec(), analog_call(), append_channel_vars(), array(), ast_bridge_call(), ast_bridge_timelimit(), ast_call_forward(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), ast_eivr_getvariable(), ast_hangup(), ast_monitor_stop(), bridge_play_sounds(), builtin_atxfer(), builtin_automixmonitor(), builtin_automonitor(), check_goto_on_transfer(), common_exec(), conf_run(), create_dynamic_parkinglot(), crement_function_read(), dahdi_hangup(), dahdi_r2_answer(), dahdi_r2_get_channel_category(), dial_exec_full(), do_forward(), dundi_exec(), dundi_helper(), feature_check(), feature_interpret(), find_by_mark(), find_conf_realtime(), findparkinglotname(), func_channel_read(), generic_fax_exec(), get_also_info(), get_index(), get_refer_info(), global_read(), gosub_run(), handle_gosub(), hash_read(), iax2_call(), iax2_exec(), import_ch(), leave_voicemail(), local_attended_transfer(), local_hangup(), local_read(), login_exec(), macro_fixup(), manager_mixmonitor(), meetme_menu_admin_extended(), minivm_delete_exec(), minivm_notify_exec(), misdn_answer(), misdn_hangup(), morsecode_exec(), notify_new_message(), oh323_call(), oh323_hangup(), park_call_exec(), park_call_full(), park_space_reserve(), pbx_builtin_background(), pbx_builtin_gotoiftime(), queue_exec(), real_ctx(), receivefax_exec(), retrydial_exec(), ring_entry(), run_agi(), sendfax_exec(), set_config_flags(), set_local_info(), setsubstate(), sig_pri_call(), sig_pri_hangup(), sig_ss7_call(), sig_ss7_hangup(), sip_addheader(), sla_trunk_exec(), speech_background(), try_calling(), try_suggested_sip_codec(), update_bridge_vars(), and wait_for_answer().

{
   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;
}

static int pbx_builtin_gotoif	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Definition at line 11793 of file pbx.c.

References ast_debug, ast_log(), ast_strlen_zero(), LOG_WARNING, pbx_builtin_goto(), and pbx_checkcondition().

{
   char *condition, *branch1, *branch2, *branch;
   char *stringp;

   if (ast_strlen_zero(data)) {
      ast_log(LOG_WARNING, "Ignoring, since there is no variable to check\n");
      return 0;
   }

   stringp = ast_strdupa(data);
   condition = strsep(&stringp,"?");
   branch1 = strsep(&stringp,":");
   branch2 = strsep(&stringp,"");
   branch = pbx_checkcondition(condition) ? branch1 : branch2;

   if (ast_strlen_zero(branch)) {
      ast_debug(1, "Not taking any branch\n");
      return 0;
   }

   return pbx_builtin_goto(chan, branch);
}

int pbx_builtin_importvar	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Todo:

XXX should do !ast_strlen_zero(..) of the args ?

Definition at line 11731 of file pbx.c.

References ast_alloca, ast_channel_get_by_name(), ast_channel_unref, ast_log(), ast_strlen_zero(), LOG_WARNING, ast_sw::name, pbx_builtin_setvar_helper(), pbx_substitute_variables_helper(), value, and VAR_BUF_SIZE.

{
   char *name;
   char *value;
   char *channel;
   char tmp[VAR_BUF_SIZE];
   static int deprecation_warning = 0;

   if (ast_strlen_zero(data)) {
      ast_log(LOG_WARNING, "Ignoring, since there is no variable to set\n");
      return 0;
   }
   tmp[0] = 0;
   if (!deprecation_warning) {
      ast_log(LOG_WARNING, "ImportVar is deprecated.  Please use Set(varname=${IMPORT(channel,variable)}) instead.\n");
      deprecation_warning = 1;
   }

   value = ast_strdupa(data);
   name = strsep(&value,"=");
   channel = strsep(&value,",");
   if (channel && value && name) { /*! \todo XXX should do !ast_strlen_zero(..) of the args ? */
      struct ast_channel *chan2 = ast_channel_get_by_name(channel);
      if (chan2) {
         char *s = ast_alloca(strlen(value) + 4);
         sprintf(s, "${%s}", value);
         pbx_substitute_variables_helper(chan2, s, tmp, sizeof(tmp) - 1);
         chan2 = ast_channel_unref(chan2);
      }
      pbx_builtin_setvar_helper(chan, name, tmp);
   }

   return(0);
}

static int pbx_builtin_incomplete	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Definition at line 11048 of file pbx.c.

References __ast_answer(), ast_check_hangup(), AST_CONTROL_INCOMPLETE, ast_indicate(), AST_PBX_INCOMPLETE, AST_STATE_UP, ast_strlen_zero(), and ast_sw::data.

{
   const char *options = data;
   int answer = 1;

   /* Some channels can receive DTMF in unanswered state; some cannot */
   if (!ast_strlen_zero(options) && strchr(options, 'n')) {
      answer = 0;
   }

   /* If the channel is hungup, stop waiting */
   if (ast_check_hangup(chan)) {
      return -1;
   } else if (ast_channel_state(chan) != AST_STATE_UP && answer) {
      __ast_answer(chan, 0, 1);
   }

   ast_indicate(chan, AST_CONTROL_INCOMPLETE);

   return AST_PBX_INCOMPLETE;
}

static int pbx_builtin_noop	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Definition at line 11766 of file pbx.c.

{
   return 0;
}

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 11570 of file pbx.c.

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_var_assign(), ast_verb, globals, globalslock, and LOG_WARNING.

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

{
   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);
}

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

Definition at line 3737 of file pbx.c.

References raise_exception().

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

static int pbx_builtin_saycharacters	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Definition at line 11854 of file pbx.c.

References ast_channel_language(), and ast_say_character_str().

{
   int res = 0;

   if (data)
      res = ast_say_character_str(chan, data, "", ast_channel_language(chan));
   return res;
}

static int pbx_builtin_saydigits	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Definition at line 11845 of file pbx.c.

References ast_channel_language(), and ast_say_digit_str().

{
   int res = 0;

   if (data)
      res = ast_say_digit_str(chan, data, "", ast_channel_language(chan));
   return res;
}

static int pbx_builtin_saynumber	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Definition at line 11817 of file pbx.c.

References ast_channel_language(), ast_copy_string(), ast_log(), ast_say_number(), ast_strlen_zero(), and LOG_WARNING.

{
   char tmp[256];
   char *number = tmp;
   char *options;

   if (ast_strlen_zero(data)) {
      ast_log(LOG_WARNING, "SayNumber requires an argument (number)\n");
      return -1;
   }
   ast_copy_string(tmp, data, sizeof(tmp));
   strsep(&number, ",");
   options = strsep(&number, ",");
   if (options) {
      if ( strcasecmp(options, "f") && strcasecmp(options, "m") &&
         strcasecmp(options, "c") && strcasecmp(options, "n") ) {
         ast_log(LOG_WARNING, "SayNumber gender option is either 'f', 'm', 'c' or 'n'\n");
         return -1;
      }
   }

   if (ast_say_number(chan, atoi(tmp), "", ast_channel_language(chan), options)) {
      ast_log(LOG_WARNING, "We were unable to say the number %s, is it too large?\n", tmp);
   }

   return 0;
}

static int pbx_builtin_sayphonetic	(	struct ast_channel *	chan,
		const char *	data
	)		[static]

Definition at line 11863 of file pbx.c.

References ast_channel_language(), and ast_say_phonetic_str().

{
   int res = 0;

   if (data)
      res = ast_say_phonetic_str(chan, data, "", ast_channel_language(chan));
   return res;
}

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 11501 of file pbx.c.

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(), ast_var_t::entries, LOG_ERROR, total, and var.

Referenced by ast_var_channels_table(), dumpchan_exec(), handle_show_chanvar(), handle_showchan(), and vars2manager().

{
   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;
}

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 11665 of file pbx.c.

References ast_compat_app_set, ast_log(), ast_strlen_zero(), LOG_WARNING, ast_sw::name, pbx_builtin_setvar_helper(), pbx_builtin_setvar_multiple(), and value.

Referenced by ast_compile_ael2().

{
   char *name, *value, *mydata;

   if (ast_compat_app_set) {
      return pbx_builtin_setvar_multiple(chan, data);
   }

   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;
}

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

Definition at line 11603 of file pbx.c.

References ast_channel_lock, ast_channel_name(), ast_channel_uniqueid(), 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_var_assign(), ast_var_delete(), ast_var_name(), ast_verb, EVENT_FLAG_DIALPLAN, globals, globalslock, manager_event, and ast_sw::name.

Referenced by __analog_ss_thread(), __ast_pbx_run(), __oh323_new(), _macro_exec(), _while_exec(), acf_curl_helper(), acf_fetch(), acf_odbc_read(), acf_odbc_write(), acf_transaction_write(), action_atxfer(), action_setvar(), admin_exec(), agi_exec_full(), aji_status_exec(), analog_ss_thread(), aqm_exec(), array(), ast_bridge_call(), ast_cc_agent_set_interfaces_chanvar(), ast_eivr_setvariable(), ast_iax2_new(), ast_monitor_start(), ast_monitor_stop(), ast_pbx_outgoing_exten(), ast_pickup_call(), ast_rtp_instance_set_stats_vars(), ast_set_cc_interfaces_chanvar(), ast_set_variables(), asyncgoto_exec(), background_detect_exec(), bridge_exec(), bridge_play_sounds(), builtin_atxfer(), builtin_automixmonitor(), builtin_automonitor(), builtin_blindtransfer(), calendar_write_exec(), cb_events(), cccancel_exec(), ccreq_exec(), chanavail_exec(), channel_spy(), commit_exec(), conf_run(), controlplayback_exec(), count_exec(), crement_function_read(), dahdi_handle_dtmf(), dahdi_new(), dial_exec_full(), disa_exec(), do_notify(), do_waiting(), end_bridge_callback(), export_aoc_vars(), export_ch(), fax_detect_framehook(), feature_exec_app(), feature_request_and_dial(), frame_set_var(), func_mchan_write(), function_db_delete(), function_db_exists(), function_db_read(), function_realtime_store(), generic_recall(), get_rdnis(), get_refer_info(), global_write(), gosub_release_frame(), gosub_run(), handle_gosub(), handle_request_bye(), handle_request_refer(), handle_set_chanvar(), handle_set_global(), handle_setvariable(), hash_read(), hash_write(), isAnsweringMachine(), launch_monitor_thread(), leave_queue(), leave_voicemail(), local_hangup(), lua_set_variable(), lua_set_variable_value(), macro_fixup(), manage_parked_call(), mgcp_new(), minivm_accmess_exec(), minivm_delete_exec(), minivm_greet_exec(), minivm_notify_exec(), minivm_record_exec(), misdn_call(), mixmonitor_exec(), msg_send_exec(), my_handle_dtmf(), originate_exec(), ospauth_exec(), ospfinished_exec(), osplookup_exec(), ospnext_exec(), parked_call_exec(), parse_moved_contact(), pbx_builtin_background(), pbx_builtin_gotoiftime(), pbx_builtin_importvar(), pbx_builtin_setvar(), pbx_builtin_setvar_multiple(), pbx_load_config(), phase_e_handler(), play_message_datetime(), playback_exec(), pqm_exec(), prep_email_sub_vars(), pri_dchannel(), privacy_exec(), process_ast_dsp(), process_sdp(), read_exec(), readexten_exec(), readfile_exec(), realtimefield_read(), receivefax_exec(), record_exec(), reload_module(), return_exec(), rollback_exec(), rotate_file(), rqm_exec(), sendfax_exec(), sendimage_exec(), sendtext_exec(), sendurl_exec(), set(), set_channel_variables(), set_queue_result(), setsubstate(), shift_pop(), sig_pri_new_ast_channel(), sig_ss7_new_ast_channel(), sip_addheader(), sip_hangup(), sip_new(), sip_read(), skinny_new(), sla_calc_trunk_timeouts(), sla_station_exec(), sla_trunk_exec(), socket_process_helper(), speech_create(), ss7_start_call(), start_monitor_exec(), system_exec_helper(), testtime_write(), transfer_exec(), transmit(), tryexec_exec(), unshift_push(), update_bridge_vars(), update_qe_rule(), upqm_exec(), vm_box_exists(), vm_exec(), vm_playmsgexec(), vmauthenticate(), waituntil_exec(), xmpp_status_exec(), and zapateller_exec().

{
   struct ast_var_t *newvariable;
   struct varshead *headp;
   const char *nametail = name;

   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);
         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);
      /*** DOCUMENTATION
         <managerEventInstance>
            <synopsis>Raised when a variable is set to a particular value.</synopsis>
         </managerEventInstance>
      ***/
      manager_event(EVENT_FLAG_DIALPLAN, "VarSet",
         "Channel: %s\r\n"
         "Variable: %s\r\n"
         "Value: %s\r\n"
         "Uniqueid: %s\r\n",
         chan ? ast_channel_name(chan) : "none", name, value,
         chan ? ast_channel_uniqueid(chan) : "none");
   }

   if (chan)
      ast_channel_unlock(chan);
   else
      ast_rwlock_unlock(&globalslock);
   return 0;
}

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 11695 of file pbx.c.

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_strlen_zero(), ast_sw::data, LOG_WARNING, ast_channel::name, pbx_builtin_setvar_helper(), and value.

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

{
   char *data;
   int x;
   AST_DECLARE_APP_ARGS(args,
      AST_APP_ARG(pair)[24];
   );
   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;
}

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 11781 of file pbx.c.

References ast_strlen_zero().

Referenced by _macro_exec(), _while_exec(), acf_if(), execif_exec(), gosubif_exec(), macroif_exec(), pbx_builtin_gotoif(), and testtime_write().

{
   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;
   }
}

static void pbx_destroy

(

struct ast_pbx *

p

)

[static]

Definition at line 1670 of file pbx.c.

References ast_free.

Referenced by __ast_pbx_run().

{
   ast_free(p);
}

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

Parameters:

c	Channel
app	Application
data	Data for execution

Definition at line 1594 of file pbx.c.

References __ast_module_user_add(), __ast_module_user_remove(), ast_cdr_setapp(), AST_CEL_APP_END, AST_CEL_APP_START, ast_cel_report_event(), ast_channel_appl(), ast_channel_appl_set(), ast_channel_cdr(), ast_channel_data(), ast_channel_data_set(), ast_check_hangup(), ast_log(), ast_opt_dont_warn, ast_strlen_zero(), ast_app::execute, LOG_WARNING, and S_OR.

Referenced by aelsub_exec(), answer_exec_run(), ast_app_exec_macro(), ast_bridge_call(), ast_pbx_run_app(), async_wait(), builtin_automixmonitor(), builtin_automonitor(), conf_run(), do_magic_pickup(), dundi_exec(), exec_exec(), execif_exec(), feature_exec_app(), forward_message(), handle_exec(), iax2_exec(), lua_pbx_exec(), page_exec(), pbx_builtin_execiftime(), pbx_extension_helper(), realtime_exec(), record_thread(), try_calling(), and tryexec_exec().

{
   int res;
   struct ast_module_user *u = NULL;
   const char *saved_c_appl;
   const char *saved_c_data;

   if (ast_channel_cdr(c) && !ast_check_hangup(c))
      ast_cdr_setapp(ast_channel_cdr(c), app->name, data);

   /* save channel values */
   saved_c_appl= ast_channel_appl(c);
   saved_c_data= ast_channel_data(c);

   ast_channel_appl_set(c, app->name);
   ast_channel_data_set(c, data);
   ast_cel_report_event(c, AST_CEL_APP_START, NULL, NULL, NULL);

   if (app->module)
      u = __ast_module_user_add(app->module, c);
   if (strcasecmp(app->name, "system") && !ast_strlen_zero(data) &&
         strchr(data, '|') && !strchr(data, ',') && !ast_opt_dont_warn) {
      ast_log(LOG_WARNING, "The application delimiter is now the comma, not "
         "the pipe.  Did you forget to convert your dialplan?  (%s(%s))\n",
         app->name, (char *) data);
   }
   res = app->execute(c, S_OR(data, ""));
   if (app->module && u)
      __ast_module_user_remove(app->module, u);
   ast_cel_report_event(c, AST_CEL_APP_END, NULL, NULL, NULL);
   /* restore channel values */
   ast_channel_appl_set(c, saved_c_appl);
   ast_channel_data_set(c, saved_c_data);
   return res;
}

static int pbx_extension_helper	(	struct ast_channel *	c,
		struct ast_context *	con,
		const char *	context,
		const char *	exten,
		int	priority,
		const char *	label,
		const char *	callerid,
		enum ext_match_t	action,
		int *	found,
		int	combined_find_spawn
	)		[static]

The return value depends on the action:

E_MATCH, E_CANMATCH, E_MATCHMORE require a real match, and return 0 on failure, -1 on match; E_FINDLABEL maps the label to a priority, and returns the priority on success, ... XXX E_SPAWN, spawn an application,

Return values:

0	on success.
-1	on failure.

Note:

The channel is auto-serviced in this function, because doing an extension match may block for a long time. For example, if the lookup has to use a network dialplan switch, such as DUNDi or IAX2, it may take a while. However, the channel auto-service code will queue up any important signalling frames to be processed after this is done.

Definition at line 4823 of file pbx.c.

References app, ast_exten::app, ast_channel_context(), ast_channel_context_set(), ast_channel_exten(), ast_channel_exten_set(), ast_channel_name(), ast_channel_priority(), ast_channel_priority_set(), ast_channel_uniqueid(), ast_copy_string(), ast_debug, ast_log(), ast_rdlock_contexts(), ast_strlen_zero(), ast_unlock_contexts(), ast_verb, ast_exten::cached_app, COLOR_BRCYAN, COLOR_BRMAGENTA, pbx_find_info::data, ast_exten::data, E_CANMATCH, E_FINDLABEL, E_MATCH, E_MATCHMORE, EVENT_FLAG_DIALPLAN, ast_switch::exec, EXT_DATA_SIZE, pbx_find_info::foundcontext, LOG_NOTICE, LOG_WARNING, manager_event, ast_switch::name, pbx_exec(), pbx_find_extension(), pbx_findapp(), pbx_substitute_variables_helper(), ast_exten::priority, S_OR, pbx_find_info::stacklen, pbx_find_info::status, STATUS_NO_CONTEXT, STATUS_NO_EXTENSION, STATUS_NO_LABEL, STATUS_NO_PRIORITY, pbx_find_info::swo, term_color(), and VERBOSITY_ATLEAST.

Referenced by ast_canmatch_extension(), ast_exists_extension(), ast_findlabel_extension(), ast_findlabel_extension2(), ast_matchmore_extension(), and ast_spawn_extension().

{
   struct ast_exten *e;
   struct ast_app *app;
   char *substitute = NULL;
   int res;
   struct pbx_find_info q = { .stacklen = 0 }; /* the rest is reset in pbx_find_extension */
   char passdata[EXT_DATA_SIZE];

   int matching_action = (action == E_MATCH || action == E_CANMATCH || action == E_MATCHMORE);

   ast_rdlock_contexts();
   if (found)
      *found = 0;

   e = pbx_find_extension(c, con, &q, context, exten, priority, label, callerid, action);
   if (e) {
      if (found)
         *found = 1;
      if (matching_action) {
         ast_unlock_contexts();
         return -1;  /* success, we found it */
      } else if (action == E_FINDLABEL) { /* map the label to a priority */
         res = e->priority;
         ast_unlock_contexts();
         return res; /* the priority we were looking for */
      } else { /* spawn */
         if (!e->cached_app)
            e->cached_app = pbx_findapp(e->app);
         app = e->cached_app;
         if (ast_strlen_zero(e->data)) {
            *passdata = '\0';
         } else {
            const char *tmp;
            if ((!(tmp = strchr(e->data, '$'))) || (!strstr(tmp, "${") && !strstr(tmp, "$["))) {
               /* no variables to substitute, copy on through */
               ast_copy_string(passdata, e->data, sizeof(passdata));
            } else {
               /* save e->data on stack for later processing after lock released */
               substitute = ast_strdupa(e->data);
            }
         }
         ast_unlock_contexts();
         if (!app) {
            ast_log(LOG_WARNING, "No application '%s' for extension (%s, %s, %d)\n", e->app, context, exten, priority);
            return -1;
         }
         if (ast_channel_context(c) != context)
            ast_channel_context_set(c, context);
         if (ast_channel_exten(c) != exten)
            ast_channel_exten_set(c, exten);
         ast_channel_priority_set(c, priority);
         if (substitute) {
            pbx_substitute_variables_helper(c, substitute, passdata, sizeof(passdata)-1);
         }
#ifdef CHANNEL_TRACE
         ast_channel_trace_update(c);
#endif
         ast_debug(1, "Launching '%s'\n", app->name);
         if (VERBOSITY_ATLEAST(3)) {
            char tmp[80], tmp2[80], tmp3[EXT_DATA_SIZE];
            ast_verb(3, "Executing [%s@%s:%d] %s(\"%s\", \"%s\") %s\n",
               exten, context, priority,
               term_color(tmp, app->name, COLOR_BRCYAN, 0, sizeof(tmp)),
               term_color(tmp2, ast_channel_name(c), COLOR_BRMAGENTA, 0, sizeof(tmp2)),
               term_color(tmp3, passdata, COLOR_BRMAGENTA, 0, sizeof(tmp3)),
               "in new stack");
         }
         /*** DOCUMENTATION
            <managerEventInstance>
               <synopsis>Raised when a channel enters a new context, extension, priority.</synopsis>
               <syntax>
                  <parameter name="Application">
                     <para>The application about to be executed.</para>
                  </parameter>
                  <parameter name="AppData">
                     <para>The data to be passed to the application.</para>
                  </parameter>
               </syntax>
            </managerEventInstance>
         ***/
         manager_event(EVENT_FLAG_DIALPLAN, "Newexten",
               "Channel: %s\r\n"
               "Context: %s\r\n"
               "Extension: %s\r\n"
               "Priority: %d\r\n"
               "Application: %s\r\n"
               "AppData: %s\r\n"
               "Uniqueid: %s\r\n",
               ast_channel_name(c), ast_channel_context(c), ast_channel_exten(c), ast_channel_priority(c), app->name, passdata, ast_channel_uniqueid(c));
         return pbx_exec(c, app, passdata);  /* 0 on success, -1 on failure */
      }
   } else if (q.swo) {  /* not found here, but in another switch */
      if (found)
         *found = 1;
      ast_unlock_contexts();
      if (matching_action) {
         return -1;
      } else {
         if (!q.swo->exec) {
            ast_log(LOG_WARNING, "No execution engine for switch %s\n", q.swo->name);
            res = -1;
         }
         return q.swo->exec(c, q.foundcontext ? q.foundcontext : context, exten, priority, callerid, q.data);
      }
   } else { /* not found anywhere, see what happened */
      ast_unlock_contexts();
      /* Using S_OR here because Solaris doesn't like NULL being passed to ast_log */
      switch (q.status) {
      case STATUS_NO_CONTEXT:
         if (!matching_action && !combined_find_spawn)
            ast_log(LOG_NOTICE, "Cannot find extension context '%s'\n", S_OR(context, ""));
         break;
      case STATUS_NO_EXTENSION:
         if (!matching_action && !combined_find_spawn)
            ast_log(LOG_NOTICE, "Cannot find extension '%s' in context '%s'\n", exten, S_OR(context, ""));
         break;
      case STATUS_NO_PRIORITY:
         if (!matching_action && !combined_find_spawn)
            ast_log(LOG_NOTICE, "No such priority %d in extension '%s' in context '%s'\n", priority, exten, S_OR(context, ""));
         break;
      case STATUS_NO_LABEL:
         if (context && !combined_find_spawn)
            ast_log(LOG_NOTICE, "No such label '%s' in extension '%s' in context '%s'\n", label, exten, S_OR(context, ""));
         break;
      default:
         ast_debug(1, "Shouldn't happen!\n");
      }

      return (matching_action) ? 0 : -1;
   }
}

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
	)		[read]

Definition at line 3110 of file pbx.c.

References ast_context::alts, ast_autoservice_start(), ast_autoservice_stop(), ast_debug, ast_hashtab_lookup(), AST_LIST_TRAVERSE, ast_log(), AST_PBX_MAX_STACK, ast_str_buffer(), ast_str_size(), ast_str_thread_get(), ast_strlen_zero(), ast_walk_context_extensions(), ast_switch::canmatch, scoreboard::canmatch_exten, context, create_match_char_tree(), pbx_find_info::data, ast_sw::data, E_CANMATCH, E_FINDLABEL, E_MATCHMORE, ast_sw::eval, ast_switch::exists, ast_exten::exten, scoreboard::exten, extension_match_core(), find_context(), pbx_find_info::foundcontext, include_valid(), ast_context::includes, pbx_find_info::incstack, ast_exten::label, scoreboard::last_char, LOG_NOTICE, LOG_WARNING, match(), matchcid(), ast_switch::matchmore, ast_sw::name, ast_context::name, new_find_extension(), ast_include::next, scoreboard::node, ast_context::pattern_tree, pbx_find_extension(), pbx_findswitch(), pbx_substitute_variables_helper(), ast_exten::priority, ast_include::rname, 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, switch_data, pbx_find_info::swo, scoreboard::total_length, scoreboard::total_specificity, and trie_find_next_match().

Referenced by ast_hint_extension_nolock(), ast_merge_contexts_and_delete(), check_goto(), check_pval_item(), get_parking_exten(), pbx_extension_helper(), pbx_find_extension(), register_peer_exten(), and remove_exten_if_exist().

{
   int x, res;
   struct ast_context *tmp = NULL;
   struct ast_exten *e = NULL, *eroot = NULL;
   struct ast_include *i = NULL;
   struct ast_sw *sw = NULL;
   struct ast_exten pattern = {NULL, };
   struct scoreboard score = {0, };
   struct ast_str *tmpdata = NULL;

   pattern.label = label;
   pattern.priority = priority;
#ifdef NEED_DEBUG_HERE
   ast_log(LOG_NOTICE, "Looking for cont/ext/prio/label/action = %s/%s/%d/%s/%d\n", context, exten, priority, label, (int) action);
#endif

   /* Initialize status if appropriate */
   if (q->stacklen == 0) {
      q->status = STATUS_NO_CONTEXT;
      q->swo = NULL;
      q->data = NULL;
      q->foundcontext = NULL;
   } else if (q->stacklen >= AST_PBX_MAX_STACK) {
      ast_log(LOG_WARNING, "Maximum PBX stack exceeded\n");
      return NULL;
   }

   /* Check first to see if we've already been checked */
   for (x = 0; x < q->stacklen; x++) {
      if (!strcasecmp(q->incstack[x], context))
         return NULL;
   }

   if (bypass) { /* bypass means we only look there */
      tmp = bypass;
   } else {      /* look in contexts */
      tmp = find_context(context);
      if (!tmp) {
         return NULL;
      }
   }

   if (q->status < STATUS_NO_EXTENSION)
      q->status = STATUS_NO_EXTENSION;

   /* Do a search for matching extension */

   eroot = NULL;
   score.total_specificity = 0;
   score.exten = 0;
   score.total_length = 0;
   if (!tmp->pattern_tree && tmp->root_table) {
      create_match_char_tree(tmp);
#ifdef NEED_DEBUG
      ast_debug(1, "Tree Created in context %s:\n", context);
      log_match_char_tree(tmp->pattern_tree," ");
#endif
   }
#ifdef NEED_DEBUG
   ast_log(LOG_NOTICE, "The Trie we are searching in:\n");
   log_match_char_tree(tmp->pattern_tree, "::  ");
#endif

   do {
      if (!ast_strlen_zero(overrideswitch)) {
         char *osw = ast_strdupa(overrideswitch), *name;
         struct ast_switch *asw;
         ast_switch_f *aswf = NULL;
         char *datap;
         int eval = 0;

         name = strsep(&osw, "/");
         asw = pbx_findswitch(name);

         if (!asw) {
            ast_log(LOG_WARNING, "No such switch '%s'\n", name);
            break;
         }

         if (osw && strchr(osw, '$')) {
            eval = 1;
         }

         if (eval && !(tmpdata = ast_str_thread_get(&switch_data, 512))) {
            ast_log(LOG_WARNING, "Can't evaluate overrideswitch?!\n");
            break;
         } else if (eval) {
            /* Substitute variables now */
            pbx_substitute_variables_helper(chan, osw, ast_str_buffer(tmpdata), ast_str_size(tmpdata));
            datap = ast_str_buffer(tmpdata);
         } else {
            datap = osw;
         }

         /* equivalent of extension_match_core() at the switch level */
         if (action == E_CANMATCH)
            aswf = asw->canmatch;
         else if (action == E_MATCHMORE)
            aswf = asw->matchmore;
         else /* action == E_MATCH */
            aswf = asw->exists;
         if (!aswf) {
            res = 0;
         } else {
            if (chan) {
               ast_autoservice_start(chan);
            }
            res = aswf(chan, context, exten, priority, callerid, datap);
            if (chan) {
               ast_autoservice_stop(chan);
            }
         }
         if (res) {  /* Got a match */
            q->swo = asw;
            q->data = datap;
            q->foundcontext = context;
            /* XXX keep status = STATUS_NO_CONTEXT ? */
            return NULL;
         }
      }
   } while (0);

   if (extenpatternmatchnew) {
      new_find_extension(exten, &score, tmp->pattern_tree, 0, 0, callerid, label, action);
      eroot = score.exten;

      if (score.last_char == '!' && action == E_MATCHMORE) {
         /* We match an extension ending in '!'.
          * The decision in this case is final and is NULL (no match).
          */
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"Returning MATCHMORE NULL with exclamation point.\n");
#endif
         return NULL;
      }

      if (!eroot && (action == E_CANMATCH || action == E_MATCHMORE) && score.canmatch_exten) {
         q->status = STATUS_SUCCESS;
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE,"Returning CANMATCH exten %s\n", score.canmatch_exten->exten);
#endif
         return score.canmatch_exten;
      }

      if ((action == E_MATCHMORE || action == E_CANMATCH)  && eroot) {
         if (score.node) {
            struct ast_exten *z = trie_find_next_match(score.node);
            if (z) {
#ifdef NEED_DEBUG_HERE
               ast_log(LOG_NOTICE,"Returning CANMATCH/MATCHMORE next_match exten %s\n", z->exten);
#endif
            } else {
               if (score.canmatch_exten) {
#ifdef NEED_DEBUG_HERE
                  ast_log(LOG_NOTICE,"Returning CANMATCH/MATCHMORE canmatchmatch exten %s(%p)\n", score.canmatch_exten->exten, score.canmatch_exten);
#endif
                  return score.canmatch_exten;
               } else {
#ifdef NEED_DEBUG_HERE
                  ast_log(LOG_NOTICE,"Returning CANMATCH/MATCHMORE next_match exten NULL\n");
#endif
               }
            }
            return z;
         }
#ifdef NEED_DEBUG_HERE
         ast_log(LOG_NOTICE, "Returning CANMATCH/MATCHMORE NULL (no next_match)\n");
#endif
         return NULL;  /* according to the code, complete matches are null matches in MATCHMORE mode */
      }

      if (eroot) {
         /* found entry, now look for the right priority */
         if (q->status < STATUS_NO_PRIORITY)
            q->status = STATUS_NO_PRIORITY;
         e = NULL;
         if (action == E_FINDLABEL && label ) {
            if (q->status < STATUS_NO_LABEL)
               q->status = STATUS_NO_LABEL;
            e = ast_hashtab_lookup(eroot->peer_label_table, &pattern);
         } else {
            e = ast_hashtab_lookup(eroot->peer_table, &pattern);
         }
         if (e) { /* found a valid match */
            q->status = STATUS_SUCCESS;
            q->foundcontext = context;
#ifdef NEED_DEBUG_HERE
            ast_log(LOG_NOTICE,"Returning complete match of exten %s\n", e->exten);
#endif
            return e;
         }
      }
   } else {   /* the old/current default exten pattern match algorithm */

      /* scan the list trying to match extension and CID */
      eroot = NULL;
      while ( (eroot = ast_walk_context_extensions(tmp, eroot)) ) {
         int match = extension_match_core(eroot->exten, exten, action);
         /* 0 on fail, 1 on match, 2 on earlymatch */

         if (!match || (eroot->matchcid && !matchcid(eroot->cidmatch, callerid)))
            continue;   /* keep trying */
         if (match == 2 && action == E_MATCHMORE) {
            /* We match an extension ending in '!'.
             * The decision in this case is final and is NULL (no match).
             */
            return NULL;
         }
         /* found entry, now look for the right priority */
         if (q->status < STATUS_NO_PRIORITY)
            q->status = STATUS_NO_PRIORITY;
         e = NULL;
         if (action == E_FINDLABEL && label ) {
            if (q->status < STATUS_NO_LABEL)
               q->status = STATUS_NO_LABEL;
            e = ast_hashtab_lookup(eroot->peer_label_table, &pattern);
         } else {
            e = ast_hashtab_lookup(eroot->peer_table, &pattern);
         }
         if (e) { /* found a valid match */
            q->status = STATUS_SUCCESS;
            q->foundcontext = context;
            return e;
         }
      }
   }

   /* Check alternative switches */
   AST_LIST_TRAVERSE(&tmp->alts, sw, list) {
      struct ast_switch *asw = pbx_findswitch(sw->name);
      ast_switch_f *aswf = NULL;
      char *datap;

      if (!asw) {
         ast_log(LOG_WARNING, "No such switch '%s'\n", sw->name);
         continue;
      }

      /* Substitute variables now */
      if (sw->eval) {
         if (!(tmpdata = ast_str_thread_get(&switch_data, 512))) {
            ast_log(LOG_WARNING, "Can't evaluate switch?!\n");
            continue;
         }
         pbx_substitute_variables_helper(chan, sw->data, ast_str_buffer(tmpdata), ast_str_size(tmpdata));
      }

      /* equivalent of extension_match_core() at the switch level */
      if (action == E_CANMATCH)
         aswf = asw->canmatch;
      else if (action == E_MATCHMORE)
         aswf = asw->matchmore;
      else /* action == E_MATCH */
         aswf = asw->exists;
      datap = sw->eval ? ast_str_buffer(tmpdata) : sw->data;
      if (!aswf)
         res = 0;
      else {
         if (chan)
            ast_autoservice_start(chan);
         res = aswf(chan, context, exten, priority, callerid, datap);
         if (chan)
            ast_autoservice_stop(chan);
      }
      if (res) {  /* Got a match */
         q->swo = asw;
         q->data = datap;
         q->foundcontext = context;
         /* XXX keep status = STATUS_NO_CONTEXT ? */
         return NULL;
      }
   }
   q->incstack[q->stacklen++] = tmp->name;   /* Setup the stack */
   /* Now try any includes we have in this context */
   for (i = tmp->includes; i; i = i->next) {
      if (include_valid(i)) {
         if ((e = pbx_find_extension(chan, bypass, q, i->rname, exten, priority, label, callerid, action))) {
#ifdef NEED_DEBUG_HERE
            ast_log(LOG_NOTICE,"Returning recursive match of %s\n", e->exten);
#endif
            return e;
         }
         if (q->swo)
            return NULL;
      }
   }
   return NULL;
}

struct ast_app* pbx_findapp

(

const char *

app

)

[read]

Find application handle in linked list.

Look up an application.

Definition at line 1634 of file pbx.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, and AST_RWLIST_UNLOCK.

Referenced by aelsub_exec(), answer_exec_run(), ast_app_exec_macro(), ast_bridge_call(), ast_pbx_run_app(), async_wait(), builtin_automixmonitor(), builtin_automonitor(), conf_run(), conf_start_record(), do_magic_pickup(), dundi_exec(), exec_exec(), execif_exec(), feature_exec_app(), forward_message(), handle_exec(), iax2_exec(), lua_pbx_exec(), page_exec(), pbx_builtin_execiftime(), pbx_extension_helper(), realtime_exec(), record_thread(), try_calling(), and tryexec_exec().

{
   struct ast_app *tmp;

   AST_RWLIST_RDLOCK(&apps);
   AST_RWLIST_TRAVERSE(&apps, tmp, list) {
      if (!strcasecmp(tmp->name, app))
         break;
   }
   AST_RWLIST_UNLOCK(&apps);

   return tmp;
}

static struct ast_switch* pbx_findswitch

(

const char *

sw

)

[static, read]

Definition at line 1648 of file pbx.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, and ast_switch::name.

Referenced by pbx_find_extension().

{
   struct ast_switch *asw;

   AST_RWLIST_RDLOCK(&switches);
   AST_RWLIST_TRAVERSE(&switches, asw, list) {
      if (!strcasecmp(asw->name, sw))
         break;
   }
   AST_RWLIST_UNLOCK(&switches);

   return asw;
}

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 4176 of file pbx.c.

References ast_log(), LOG_NOTICE, and LOG_WARNING.

Referenced by ast_readconfig().

{
   if (new_live_dangerously && !live_dangerously) {
      ast_log(LOG_WARNING, "Privilege escalation protection disabled!\n"
         "See https://wiki.asterisk.org/wiki/x/1gKfAQ for more details.\n");
   }

   if (!new_live_dangerously && live_dangerously) {
      ast_log(LOG_NOTICE, "Privilege escalation protection enabled.\n");
   }
   live_dangerously = new_live_dangerously;
}

static int pbx_parseable_goto	(	struct ast_channel *	chan,
		const char *	goto_string,
		int	async
	)		[static]

Definition at line 12293 of file pbx.c.

References ast_async_goto(), ast_channel_caller(), ast_channel_context(), ast_channel_exten(), ast_channel_priority(), ast_explicit_goto(), ast_findlabel_extension(), ast_log(), ast_strlen_zero(), context, exten, LOG_WARNING, and S_COR.

Referenced by ast_async_parseable_goto(), and ast_parseable_goto().

{
   char *exten, *pri, *context;
   char *stringp;
   int ipri;
   int mode = 0;

   if (ast_strlen_zero(goto_string)) {
      ast_log(LOG_WARNING, "Goto requires an argument ([[context,]extension,]priority)\n");
      return -1;
   }
   stringp = ast_strdupa(goto_string);
   context = strsep(&stringp, ","); /* guaranteed non-null */
   exten = strsep(&stringp, ",");
   pri = strsep(&stringp, ",");
   if (!exten) {  /* Only a priority in this one */
      pri = context;
      exten = NULL;
      context = NULL;
   } else if (!pri) {   /* Only an extension and priority in this one */
      pri = exten;
      exten = context;
      context = NULL;
   }
   if (*pri == '+') {
      mode = 1;
      pri++;
   } else if (*pri == '-') {
      mode = -1;
      pri++;
   }
   if (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
         mode = 0;
   }
   /* At this point we have a priority and maybe an extension and a context */

   if (mode)
      ipri = ast_channel_priority(chan) + (ipri * mode);

   if (async)
      ast_async_goto(chan, context, exten, ipri);
   else
      ast_explicit_goto(chan, context, exten, ipri);

   return 0;

}

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

Support for Asterisk built-in variables in the dialplan.

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 3531 of file pbx.c.

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

Referenced by action_getvar(), action_status(), handle_getvariable(), lua_get_variable(), lua_get_variable_value(), and pbx_substitute_variables_helper_full().

{
   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);
}

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 6906 of file pbx.c.

References autofallthrough.

Referenced by pbx_load_module().

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

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 6913 of file pbx.c.

References extenpatternmatchnew.

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

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

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 6920 of file pbx.c.

References ast_free, ast_strdup, and ast_strlen_zero().

Referenced by pbx_load_module().

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

static void pbx_shutdown

(

void

)

[static]

Definition at line 12417 of file pbx.c.

References ao2_ref, ast_hashtab_destroy(), and pbx_builtin_clear_globals().

Referenced by ast_pbx_init().

{
   if (hints) {
      ao2_ref(hints, -1);
      hints = NULL;
   }
   if (hintdevices) {
      ao2_ref(hintdevices, -1);
      hintdevices = NULL;
   }
   if (statecbs) {
      ao2_ref(statecbs, -1);
      statecbs = NULL;
   }
   if (contexts_table) {
      ast_hashtab_destroy(contexts_table, NULL);
   }
   pbx_builtin_clear_globals();
}

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

Definition at line 4793 of file pbx.c.

References ast_channel_varshead(), and pbx_substitute_variables_helper_full().

Referenced by add_extensions(), ast_add_extension2_lockopt(), function_eval(), get_manager_event_info(), get_mapping_weight(), import_helper(), launch_monitor_thread(), manager_log(), pbx_builtin_importvar(), pbx_extension_helper(), pbx_find_extension(), pbx_load_config(), realtime_exec(), rotate_file(), substituted(), try_calling(), and write_cdr().

{
   size_t used;
   pbx_substitute_variables_helper_full(c, (c) ? ast_channel_varshead(c) : NULL, cp1, cp2, count, &used);
}

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

Definition at line 4597 of file pbx.c.

References ast_alloca, 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(), len(), LOG_ERROR, LOG_WARNING, parse_variable_name(), pbx_retrieve_variable(), pbx_substitute_variables_helper_full(), substring(), var, and VAR_BUF_SIZE.

Referenced by pbx_substitute_variables_helper(), pbx_substitute_variables_helper_full(), and pbx_substitute_variables_varshead().

{
   /* Substitutes variables into cp2, based on string cp1, cp2 NO LONGER NEEDS TO BE ZEROED OUT!!!!  */
   char *cp4 = NULL;
   const char *whereweare, *orig_cp2 = cp2;
   int length, offset, offset2, isfunction;
   char *workspace = NULL;
   char *ltmp = NULL, *var = NULL;
   char *nextvar, *nextexp, *nextthing;
   char *vars, *vare;
   int pos, brackets, needsub, len;

   *cp2 = 0; /* just in case nothing ends up there */
   whereweare = cp1;
   while (!ast_strlen_zero(whereweare) && count) {
      /* Assume we're copying the whole remaining string */
      pos = strlen(whereweare);
      nextvar = NULL;
      nextexp = NULL;
      nextthing = strchr(whereweare, '$');
      if (nextthing) {
         switch (nextthing[1]) {
         case '{':
            nextvar = nextthing;
            pos = nextvar - whereweare;
            break;
         case '[':
            nextexp = nextthing;
            pos = nextexp - whereweare;
            break;
         default:
            pos = 1;
         }
      }

      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) {
         /* 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++;
            } else if (vare[0] == '{') {
               brackets++;
            } else if (vare[0] == '}') {
               brackets--;
            } else if ((vare[0] == '$') && (vare[1] == '['))
               needsub++;
            vare++;
         }
         if (brackets)
            ast_log(LOG_WARNING, "Error in extension logic (missing '}')\n");
         len = vare - vars - 1;

         /* Skip totally over variable string */
         whereweare += (len + 3);

         if (!var)
            var = ast_alloca(VAR_BUF_SIZE);

         /* Store variable name (and truncate) */
         ast_copy_string(var, vars, len + 1);

         /* Substitute if necessary */
         if (needsub) {
            size_t used;
            if (!ltmp)
               ltmp = ast_alloca(VAR_BUF_SIZE);

            pbx_substitute_variables_helper_full(c, headp, var, ltmp, VAR_BUF_SIZE - 1, &used);
            vars = ltmp;
         } else {
            vars = var;
         }

         if (!workspace)
            workspace = ast_alloca(VAR_BUF_SIZE);

         workspace[0] = '\0';

         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 *c = ast_dummy_channel_alloc();
               if (c) {
                  memcpy(&old, ast_channel_varshead(c), sizeof(old));
                  memcpy(ast_channel_varshead(c), headp, sizeof(*ast_channel_varshead(c)));
                  cp4 = ast_func_read(c, vars, workspace, VAR_BUF_SIZE) ? NULL : workspace;
                  /* Don't deallocate the varshead that was passed in */
                  memcpy(ast_channel_varshead(c), &old, sizeof(*ast_channel_varshead(c)));
                  c = ast_channel_unref(c);
               } else {
                  ast_log(LOG_ERROR, "Unable to allocate bogus channel for variable substitution.  Function results may be blank.\n");
               }
            }
            ast_debug(2, "Function %s result is '%s'\n", vars, cp4 ? cp4 : "(null)");
         } else {
            /* Retrieve variable value */
            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++;
         }
         if (brackets)
            ast_log(LOG_WARNING, "Error in extension logic (missing ']')\n");
         len = vare - vars - 1;

         /* Skip totally over expression */
         whereweare += (len + 3);

         if (!var)
            var = ast_alloca(VAR_BUF_SIZE);

         /* Store variable name (and truncate) */
         ast_copy_string(var, vars, len + 1);

         /* Substitute if necessary */
         if (needsub) {
            size_t used;
            if (!ltmp)
               ltmp = ast_alloca(VAR_BUF_SIZE);

            pbx_substitute_variables_helper_full(c, headp, var, ltmp, VAR_BUF_SIZE - 1, &used);
            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;
         }
      }
   }
   *used = cp2 - orig_cp2;
}

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

Definition at line 4799 of file pbx.c.

References pbx_substitute_variables_helper_full().

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

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

static void* pbx_thread

(

void *

data

)

[static]

Definition at line 6824 of file pbx.c.

References __ast_pbx_run(), ast_sw::data, and decrease_call_count().

Referenced by ast_pbx_start().

{
   /* Oh joyeous kernel, we're a new thread, with nothing to do but
      answer this channel and get it going.
   */
   /* NOTE:
      The launcher of this function _MUST_ increment 'countcalls'
      before invoking the function; it will be decremented when the
      PBX has finished running on the channel
    */
   struct ast_channel *c = data;

   __ast_pbx_run(c, NULL);
   decrease_call_count();

   pthread_exit(NULL);

   return NULL;
}

static void presence_state_cb	(	const struct ast_event *	event,
		void *	unused
	)		[static]

Definition at line 11880 of file pbx.c.

References ao2_alloc, ao2_ref, ast_event_get_ie_str(), ast_event_get_ie_uint(), AST_EVENT_IE_PRESENCE_MESSAGE, AST_EVENT_IE_PRESENCE_PROVIDER, AST_EVENT_IE_PRESENCE_STATE, AST_EVENT_IE_PRESENCE_SUBTYPE, ast_log(), ast_strdup, ast_strlen_zero(), ast_taskprocessor_push(), handle_presencechange(), LOG_ERROR, presencechange::message, presencechange_destroy(), presencechange::provider, presencechange::state, and presencechange::subtype.

Referenced by load_pbx().

{
   struct presencechange *pc;
   const char *tmp;

   if (!(pc = ao2_alloc(sizeof(*pc), presencechange_destroy))) {
      return;
   }

   tmp = ast_event_get_ie_str(event, AST_EVENT_IE_PRESENCE_PROVIDER);
   if (ast_strlen_zero(tmp)) {
      ast_log(LOG_ERROR, "Received invalid event that had no presence provider IE\n");
      ao2_ref(pc, -1);
      return;
   }
   pc->provider = ast_strdup(tmp);

   pc->state = ast_event_get_ie_uint(event, AST_EVENT_IE_PRESENCE_STATE);
   if (pc->state < 0) {
      ao2_ref(pc, -1);
      return;
   }

   if ((tmp = ast_event_get_ie_str(event, AST_EVENT_IE_PRESENCE_SUBTYPE))) {
      pc->subtype = ast_strdup(tmp);
   }

   if ((tmp = ast_event_get_ie_str(event, AST_EVENT_IE_PRESENCE_MESSAGE))) {
      pc->message = ast_strdup(tmp);
   }

   /* The task processor thread is taking our reference to the presencechange object. */
   if (ast_taskprocessor_push(extension_state_tps, handle_presencechange, pc) < 0) {
      ao2_ref(pc, -1);
   }
}

static void presencechange_destroy

(

void *

data

)

[static]

Definition at line 11872 of file pbx.c.

References ast_free, ast_sw::data, presencechange::message, presencechange::provider, and presencechange::subtype.

Referenced by presence_state_cb().

{
   struct presencechange *pc = data;
   ast_free(pc->provider);
   ast_free(pc->subtype);
   ast_free(pc->message);
}

static void print_app_docs	(	struct ast_app *	aa,
		int	fd
	)		[static]

Definition at line 7433 of file pbx.c.

References ast_app::arguments, ast_cli(), ast_free, ast_malloc, AST_MAX_APP, AST_TERM_MAX_ESCAPE_CHARS, AST_XML_DOC, ast_xmldoc_printable(), COLOR_CYAN, COLOR_MAGENTA, ast_switch::description, ast_app::description, ast_app::docsrc, S_OR, ast_app::seealso, synopsis, ast_app::synopsis, ast_app::syntax, and term_color().

Referenced by handle_show_application().

{
   /* Maximum number of characters added by terminal coloring is 22 */
   char infotitle[64 + AST_MAX_APP + 22], syntitle[40], destitle[40], stxtitle[40], argtitle[40];
   char seealsotitle[40];
   char info[64 + AST_MAX_APP], *synopsis = NULL, *description = NULL, *syntax = NULL, *arguments = NULL;
   char *seealso = NULL;
   int syntax_size, synopsis_size, description_size, arguments_size, seealso_size;

   snprintf(info, sizeof(info), "\n  -= Info about application '%s' =- \n\n", aa->name);
   term_color(infotitle, info, COLOR_MAGENTA, 0, sizeof(infotitle));

   term_color(syntitle, "[Synopsis]\n", COLOR_MAGENTA, 0, 40);
   term_color(destitle, "[Description]\n", COLOR_MAGENTA, 0, 40);
   term_color(stxtitle, "[Syntax]\n", COLOR_MAGENTA, 0, 40);
   term_color(argtitle, "[Arguments]\n", COLOR_MAGENTA, 0, 40);
   term_color(seealsotitle, "[See Also]\n", COLOR_MAGENTA, 0, 40);

#ifdef AST_XML_DOCS
   if (aa->docsrc == AST_XML_DOC) {
      description = ast_xmldoc_printable(S_OR(aa->description, "Not available"), 1);
      arguments = ast_xmldoc_printable(S_OR(aa->arguments, "Not available"), 1);
      synopsis = ast_xmldoc_printable(S_OR(aa->synopsis, "Not available"), 1);
      seealso = ast_xmldoc_printable(S_OR(aa->seealso, "Not available"), 1);

      if (!synopsis || !description || !arguments || !seealso) {
         goto return_cleanup;
      }
   } else
#endif
   {
      synopsis_size = strlen(S_OR(aa->synopsis, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      synopsis = ast_malloc(synopsis_size);

      description_size = strlen(S_OR(aa->description, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      description = ast_malloc(description_size);

      arguments_size = strlen(S_OR(aa->arguments, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      arguments = ast_malloc(arguments_size);

      seealso_size = strlen(S_OR(aa->seealso, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
      seealso = ast_malloc(seealso_size);

      if (!synopsis || !description || !arguments || !seealso) {
         goto return_cleanup;
      }

      term_color(synopsis, S_OR(aa->synopsis, "Not available"), COLOR_CYAN, 0, synopsis_size);
      term_color(description, S_OR(aa->description, "Not available"),   COLOR_CYAN, 0, description_size);
      term_color(arguments, S_OR(aa->arguments, "Not available"), COLOR_CYAN, 0, arguments_size);
      term_color(seealso, S_OR(aa->seealso, "Not available"), COLOR_CYAN, 0, seealso_size);
   }

   /* Handle the syntax the same for both XML and raw docs */
   syntax_size = strlen(S_OR(aa->syntax, "Not Available")) + AST_TERM_MAX_ESCAPE_CHARS;
   if (!(syntax = ast_malloc(syntax_size))) {
      goto return_cleanup;
   }
   term_color(syntax, S_OR(aa->syntax, "Not available"), COLOR_CYAN, 0, syntax_size);

   ast_cli(fd, "%s%s%s\n\n%s%s\n\n%s%s\n\n%s%s\n\n%s%s\n",
         infotitle, syntitle, synopsis, destitle, description,
         stxtitle, syntax, argtitle, arguments, seealsotitle, seealso);

return_cleanup:
   ast_free(description);
   ast_free(arguments);
   ast_free(synopsis);
   ast_free(seealso);
   ast_free(syntax);
}

static void print_ext	(	struct ast_exten *	e,
		char *	buf,
		int	buflen
	)		[static]

helper function to print an extension

Definition at line 7859 of file pbx.c.

References ast_get_extension_app(), ast_get_extension_app_data(), ast_get_extension_priority(), ast_strlen_zero(), and PRIORITY_HINT.

Referenced by show_dialplan_helper().

{
   int prio = ast_get_extension_priority(e);
   if (prio == PRIORITY_HINT) {
      snprintf(buf, buflen, "hint: %s",
         ast_get_extension_app(e));
   } else {
      snprintf(buf, buflen, "%d. %s(%s)",
         prio, ast_get_extension_app(e),
         (!ast_strlen_zero(ast_get_extension_app_data(e)) ? (char *)ast_get_extension_app_data(e) : ""));
   }
}

static int raise_exception	(	struct ast_channel *	chan,
		const char *	reason,
		int	priority
	)		[static]

Definition at line 3711 of file pbx.c.

References ast_calloc_with_stringfields, ast_channel_context(), ast_channel_datastore_add(), ast_channel_datastore_find(), ast_channel_exten(), ast_channel_priority(), ast_datastore_alloc(), ast_datastore_free(), ast_string_field_set, ast_datastore::data, exception_store_info, exten, pbx_exception::priority, and set_ext_pri().

Referenced by __ast_pbx_run(), pbx_builtin_raise_exception(), and pbx_builtin_waitexten().

{
   struct ast_datastore *ds = ast_channel_datastore_find(chan, &exception_store_info, NULL);
   struct pbx_exception *exception = NULL;

   if (!ds) {
      ds = ast_datastore_alloc(&exception_store_info, NULL);
      if (!ds)
         return -1;
      if (!(exception = ast_calloc_with_stringfields(1, struct pbx_exception, 128))) {
         ast_datastore_free(ds);
         return -1;
      }
      ds->data = exception;
      ast_channel_datastore_add(chan, ds);
   } else
      exception = ds->data;

   ast_string_field_set(exception, reason, reason);
   ast_string_field_set(exception, context, ast_channel_context(chan));
   ast_string_field_set(exception, exten, ast_channel_exten(chan));
   exception->priority = ast_channel_priority(chan);
   set_ext_pri(chan, "e", priority);
   return 0;
}

static int read_escalates

(

const struct ast_custom_function *

acf

)

[static]

Returns true if given custom function escalates privileges on read.

Parameters:

acf	Custom function to query.

Returns:

True (non-zero) if reads escalate privileges.

False (zero) if reads just read.

Definition at line 3973 of file pbx.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, and AST_RWLIST_UNLOCK.

Referenced by is_read_allowed().

                                                                 {
   int res = 0;
   struct ast_custom_escalating_function *cur_escalation;

   AST_RWLIST_RDLOCK(&escalation_root);
   AST_RWLIST_TRAVERSE(&escalation_root, cur_escalation, list) {
      if (cur_escalation->acf == acf) {
         res = cur_escalation->read_escalates;
         break;
      }
   }
   AST_RWLIST_UNLOCK(&escalation_root);
   return res;
}

static int remove_hintdevice

(

struct ast_hint *

hint

)

[static]

Definition at line 1056 of file pbx.c.

References ao2_t_callback, hintdevice_remove_cb(), OBJ_MULTIPLE, OBJ_NODATA, and OBJ_UNLINK.

Referenced by ast_change_hint(), and ast_remove_hint().

{
   /* iterate through all devices and remove the devices which are linked to this hint */
   ao2_t_callback(hintdevices, OBJ_NODATA | OBJ_MULTIPLE | OBJ_UNLINK,
      hintdevice_remove_cb, hint,
      "callback to remove all devices which are linked to a hint");
   return 0;
}

static void set_ext_pri	(	struct ast_channel *	c,
		const char *	exten,
		int	pri
	)		[static]

helper function to set extension and priority

Definition at line 6389 of file pbx.c.

References ast_channel_exten_set(), ast_channel_lock, ast_channel_priority_set(), and ast_channel_unlock.

Referenced by __ast_pbx_run(), ast_pbx_outgoing_exten(), pbx_builtin_waitexten(), and raise_exception().

{
   ast_channel_lock(c);
   ast_channel_exten_set(c, exten);
   ast_channel_priority_set(c, pri);
   ast_channel_unlock(c);
}

static int show_debug_helper	(	int	fd,
		const char *	context,
		const char *	exten,
		struct dialplan_counters *	dpc,
		struct ast_include *	rinclude,
		int	includecount,
		const char *	includes[]
	)		[static]

Definition at line 8024 of file pbx.c.

References ast_cli(), ast_exists_extension(), ast_get_context_name(), ast_get_context_registrar(), ast_rdlock_context(), ast_rdlock_contexts(), ast_unlock_context(), ast_unlock_contexts(), ast_walk_contexts(), cli_match_char_tree(), dialplan_counters::context_existence, ast_context::name, ast_context::pattern_tree, dialplan_counters::total_context, and dialplan_counters::total_exten.

Referenced by handle_debug_dialplan().

{
   struct ast_context *c = NULL;
   int res = 0, old_total_exten = dpc->total_exten;

   ast_cli(fd,"\n     In-mem exten Trie for Fast Extension Pattern Matching:\n\n");

   ast_cli(fd,"\n           Explanation: Node Contents Format = <char(s) to match>:<pattern?>:<specif>:[matched extension]\n");
   ast_cli(fd,    "                        Where <char(s) to match> is a set of chars, any one of which should match the current character\n");
   ast_cli(fd,    "                              <pattern?>: Y if this a pattern match (eg. _XZN[5-7]), N otherwise\n");
   ast_cli(fd,    "                              <specif>: an assigned 'exactness' number for this matching char. The lower the number, the more exact the match\n");
   ast_cli(fd,    "                              [matched exten]: If all chars matched to this point, which extension this matches. In form: EXTEN:<exten string>\n");
   ast_cli(fd,    "                        In general, you match a trie node to a string character, from left to right. All possible matching chars\n");
   ast_cli(fd,    "                        are in a string vertically, separated by an unbroken string of '+' characters.\n\n");
   ast_rdlock_contexts();

   /* walk all contexts ... */
   while ( (c = ast_walk_contexts(c)) ) {
      int context_info_printed = 0;

      if (context && strcmp(ast_get_context_name(c), context))
         continue;   /* skip this one, name doesn't match */

      dpc->context_existence = 1;

      if (!c->pattern_tree) {
         /* Ignore check_return warning from Coverity for ast_exists_extension below */
         ast_exists_extension(NULL, c->name, "s", 1, ""); /* do this to force the trie to built, if it is not already */
      }

      ast_rdlock_context(c);

      dpc->total_context++;
      ast_cli(fd, "[ Context '%s' created by '%s' ]\n",
         ast_get_context_name(c), ast_get_context_registrar(c));
      context_info_printed = 1;

      if (c->pattern_tree)
      {
         cli_match_char_tree(c->pattern_tree, " ", fd);
      } else {
         ast_cli(fd,"\n     No Pattern Trie present. Perhaps the context is empty...or there is trouble...\n\n");
      }

      ast_unlock_context(c);

      /* if we print something in context, make an empty line */
      if (context_info_printed)
         ast_cli(fd, "\n");
   }
   ast_unlock_contexts();

   return (dpc->total_exten == old_total_exten) ? -1 : res;
}

static int show_dialplan_helper	(	int	fd,
		const char *	context,
		const char *	exten,
		struct dialplan_counters *	dpc,
		struct ast_include *	rinclude,
		int	includecount,
		const char *	includes[]
	)		[static]

Definition at line 7873 of file pbx.c.

References ast_cli(), AST_EXT_MATCHCID_ON, ast_extension_match(), ast_get_context_name(), ast_get_context_registrar(), ast_get_extension_label(), ast_get_extension_name(), ast_get_extension_registrar(), ast_get_ignorepat_name(), ast_get_ignorepat_registrar(), ast_get_include_name(), ast_get_include_registrar(), ast_get_switch_data(), ast_get_switch_name(), ast_get_switch_registrar(), ast_log(), AST_MAX_EXTENSION, AST_PBX_MAX_STACK, ast_rdlock_context(), ast_rdlock_contexts(), ast_unlock_context(), ast_unlock_contexts(), ast_walk_context_extensions(), ast_walk_context_ignorepats(), ast_walk_context_includes(), ast_walk_context_switches(), ast_walk_contexts(), ast_walk_extension_priorities(), buf2, ast_exten::cidmatch, dialplan_counters::context_existence, el, dialplan_counters::extension_existence, LOG_WARNING, ast_exten::matchcid, print_ext(), dialplan_counters::total_context, dialplan_counters::total_exten, and dialplan_counters::total_prio.

Referenced by handle_show_dialplan().

{
   struct ast_context *c = NULL;
   int res = 0, old_total_exten = dpc->total_exten;

   ast_rdlock_contexts();

   /* walk all contexts ... */
   while ( (c = ast_walk_contexts(c)) ) {
      struct ast_exten *e;
      struct ast_include *i;
      struct ast_ignorepat *ip;
      char buf[256], buf2[256];
      int context_info_printed = 0;

      if (context && strcmp(ast_get_context_name(c), context))
         continue;   /* skip this one, name doesn't match */

      dpc->context_existence = 1;

      ast_rdlock_context(c);

      /* are we looking for exten too? if yes, we print context
       * only if we find our extension.
       * Otherwise print context even if empty ?
       * XXX i am not sure how the rinclude is handled.
       * I think it ought to go inside.
       */
      if (!exten) {
         dpc->total_context++;
         ast_cli(fd, "[ Context '%s' created by '%s' ]\n",
            ast_get_context_name(c), ast_get_context_registrar(c));
         context_info_printed = 1;
      }

      /* walk extensions ... */
      e = NULL;
      while ( (e = ast_walk_context_extensions(c, e)) ) {
         struct ast_exten *p;

         if (exten && !ast_extension_match(ast_get_extension_name(e), exten))
            continue;   /* skip, extension match failed */

         dpc->extension_existence = 1;

         /* may we print context info? */
         if (!context_info_printed) {
            dpc->total_context++;
            if (rinclude) { /* TODO Print more info about rinclude */
               ast_cli(fd, "[ Included context '%s' created by '%s' ]\n",
                  ast_get_context_name(c), ast_get_context_registrar(c));
            } else {
               ast_cli(fd, "[ Context '%s' created by '%s' ]\n",
                  ast_get_context_name(c), ast_get_context_registrar(c));
            }
            context_info_printed = 1;
         }
         dpc->total_prio++;

         /* write extension name and first peer */
         if (e->matchcid == AST_EXT_MATCHCID_ON)
            snprintf(buf, sizeof(buf), "'%s' (CID match '%s') => ", ast_get_extension_name(e), e->cidmatch);
         else
            snprintf(buf, sizeof(buf), "'%s' =>", ast_get_extension_name(e));

         print_ext(e, buf2, sizeof(buf2));

         ast_cli(fd, "  %-17s %-45s [%s]\n", buf, buf2,
            ast_get_extension_registrar(e));

         dpc->total_exten++;
         /* walk next extension peers */
         p = e;   /* skip the first one, we already got it */
         while ( (p = ast_walk_extension_priorities(e, p)) ) {
            const char *el = ast_get_extension_label(p);
            dpc->total_prio++;
            if (el)
               snprintf(buf, sizeof(buf), "   [%s]", el);
            else
               buf[0] = '\0';
            print_ext(p, buf2, sizeof(buf2));

            ast_cli(fd,"  %-17s %-45s [%s]\n", buf, buf2,
               ast_get_extension_registrar(p));
         }
      }

      /* walk included and write info ... */
      i = NULL;
      while ( (i = ast_walk_context_includes(c, i)) ) {
         snprintf(buf, sizeof(buf), "'%s'", ast_get_include_name(i));
         if (exten) {
            /* Check all includes for the requested extension */
            if (includecount >= AST_PBX_MAX_STACK) {
               ast_log(LOG_WARNING, "Maximum include depth exceeded!\n");
            } else {
               int dupe = 0;
               int x;
               for (x = 0; x < includecount; x++) {
                  if (!strcasecmp(includes[x], ast_get_include_name(i))) {
                     dupe++;
                     break;
                  }
               }
               if (!dupe) {
                  includes[includecount] = ast_get_include_name(i);
                  show_dialplan_helper(fd, ast_get_include_name(i), exten, dpc, i, includecount + 1, includes);
               } else {
                  ast_log(LOG_WARNING, "Avoiding circular include of %s within %s\n", ast_get_include_name(i), context);
               }
            }
         } else {
            ast_cli(fd, "  Include =>        %-45s [%s]\n",
               buf, ast_get_include_registrar(i));
         }
      }

      /* walk ignore patterns and write info ... */
      ip = NULL;
      while ( (ip = ast_walk_context_ignorepats(c, ip)) ) {
         const char *ipname = ast_get_ignorepat_name(ip);
         char ignorepat[AST_MAX_EXTENSION];
         snprintf(buf, sizeof(buf), "'%s'", ipname);
         snprintf(ignorepat, sizeof(ignorepat), "_%s.", ipname);
         if (!exten || ast_extension_match(ignorepat, exten)) {
            ast_cli(fd, "  Ignore pattern => %-45s [%s]\n",
               buf, ast_get_ignorepat_registrar(ip));
         }
      }
      if (!rinclude) {
         struct ast_sw *sw = NULL;
         while ( (sw = ast_walk_context_switches(c, sw)) ) {
            snprintf(buf, sizeof(buf), "'%s/%s'",
               ast_get_switch_name(sw),
               ast_get_switch_data(sw));
            ast_cli(fd, "  Alt. Switch =>    %-45s [%s]\n",
               buf, ast_get_switch_registrar(sw));
         }
      }

      ast_unlock_context(c);

      /* if we print something in context, make an empty line */
      if (context_info_printed)
         ast_cli(fd, "\n");
   }
   ast_unlock_contexts();

   return (dpc->total_exten == old_total_exten) ? -1 : res;
}

static int statecbs_cmp	(	void *	obj,
		void *	arg,
		int	flags
	)		[static]

Definition at line 12405 of file pbx.c.

References ast_state_cb::change_cb, CMP_MATCH, and CMP_STOP.

Referenced by ast_pbx_init().

{
   const struct ast_state_cb *state_cb = obj;
   ast_state_cb_type change_cb = arg;

   return (state_cb->change_cb == change_cb) ? CMP_MATCH | CMP_STOP : 0;
}

static char* substring	(	const char *	value,
		int	offset,
		int	length,
		char *	workspace,
		size_t	workspace_len
	)		[static]

takes a substring. It is ok to call with value == workspace.

Parameters:

value
offset	< 0 means start from the end of the string and set the beginning to be that many characters back.
length	is the length of the substring, a value less than 0 means to leave that many off the end.
workspace
workspace_len	Always return a copy in workspace.

Definition at line 3441 of file pbx.c.

References ast_copy_string().

Referenced by pbx_substitute_variables_helper_full().

{
   char *ret = workspace;
   int lr;  /* length of the input string after the copy */

   ast_copy_string(workspace, value, workspace_len); /* always make a copy */

   lr = strlen(ret); /* compute length after copy, so we never go out of the workspace */

   /* Quick check if no need to do anything */
   if (offset == 0 && length >= lr) /* take the whole string */
      return ret;

   if (offset < 0)   {  /* translate negative offset into positive ones */
      offset = lr + offset;
      if (offset < 0) /* If the negative offset was greater than the length of the string, just start at the beginning */
         offset = 0;
   }

   /* too large offset result in empty string so we know what to return */
   if (offset >= lr)
      return ret + lr;  /* the final '\0' */

   ret += offset;    /* move to the start position */
   if (length >= 0 && length < lr - offset)  /* truncate if necessary */
      ret[length] = '\0';
   else if (length < 0) {
      if (lr > offset - length) /* After we remove from the front and from the rear, is there anything left? */
         ret[lr + length - offset] = '\0';
      else
         ret[0] = '\0';
   }

   return ret;
}

static int thread_inhibits_escalations

(

void

)

[static]

Indicates whether the current thread inhibits the execution of dangerous functions.

Returns:

True (non-zero) if dangerous function execution is inhibited.

False (zero) if dangerous function execution is allowed.

Definition at line 4212 of file pbx.c.

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

Referenced by is_read_allowed(), and is_write_allowed().

{
   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 checking thread's ability to run dangerous functions\n");
      /* On error, assume that we are inhibiting */
      return 1;
   }

   return *thread_inhibit_escalations;
}

static struct ast_exten* trie_find_next_match

(

struct match_char *

node

)

[static, read]

Definition at line 1845 of file pbx.c.

References match_char::alt_char, match_char::exten, match_char::next_char, and match_char::x.

Referenced by pbx_find_extension().

{
   struct match_char *m3;
   struct match_char *m4;
   struct ast_exten *e3;

   if (node && node->x[0] == '.' && !node->x[1]) { /* dot and ! will ALWAYS be next match in a matchmore */
      return node->exten;
   }

   if (node && node->x[0] == '!' && !node->x[1]) {
      return node->exten;
   }

   if (!node || !node->next_char) {
      return NULL;
   }

   m3 = node->next_char;

   if (m3->exten) {
      return m3->exten;
   }
   for (m4 = m3->alt_char; m4; m4 = m4->alt_char) {
      if (m4->exten) {
         return m4->exten;
      }
   }
   for (m4 = m3; m4; m4 = m4->alt_char) {
      e3 = trie_find_next_match(m3);
      if (e3) {
         return e3;
      }
   }

   return NULL;
}

static void unload_pbx

(

void

)

[static]

Definition at line 11988 of file pbx.c.

References ARRAY_LEN, ast_cli_unregister_multiple(), ast_custom_function_unregister(), ast_data_unregister, ast_event_unsubscribe(), ast_manager_unregister(), ast_taskprocessor_unreference(), ast_unregister_application(), builtins, exception_function, pbx_cli, and testtime_function.

Referenced by load_pbx().

{
   int x;

   if (presence_state_sub) {
      presence_state_sub = ast_event_unsubscribe(presence_state_sub);
   }
   if (device_state_sub) {
      device_state_sub = ast_event_unsubscribe(device_state_sub);
   }

   /* Unregister builtin applications */
   for (x = 0; x < ARRAY_LEN(builtins); x++) {
      ast_unregister_application(builtins[x].name);
   }
   ast_manager_unregister("ShowDialPlan");
   ast_cli_unregister_multiple(pbx_cli, ARRAY_LEN(pbx_cli));
   ast_custom_function_unregister(&exception_function);
   ast_custom_function_unregister(&testtime_function);
   ast_data_unregister(NULL);
   if (extension_state_tps) {
      extension_state_tps = ast_taskprocessor_unreference(extension_state_tps);
   }
}

static void unreference_cached_app

(

struct ast_app *

app

)

[static]

Definition at line 8638 of file pbx.c.

References ast_rdlock_contexts(), ast_unlock_contexts(), ast_walk_context_extensions(), ast_walk_contexts(), and ast_walk_extension_priorities().

Referenced by ast_unregister_application().

{
   struct ast_context *context = NULL;
   struct ast_exten *eroot = NULL, *e = NULL;

   ast_rdlock_contexts();
   while ((context = ast_walk_contexts(context))) {
      while ((eroot = ast_walk_context_extensions(context, eroot))) {
         while ((e = ast_walk_extension_priorities(eroot, e))) {
            if (e->cached_app == app)
               e->cached_app = NULL;
         }
      }
   }
   ast_unlock_contexts();

   return;
}

static void update_scoreboard	(	struct scoreboard *	board,
		int	length,
		int	spec,
		struct ast_exten *	exten,
		char	last,
		const char *	callerid,
		int	deleted,
		struct match_char *	node
	)		[static]

Definition at line 1749 of file pbx.c.

References ast_log(), exten, ast_exten::exten, scoreboard::exten, last, scoreboard::last_char, LOG_NOTICE, scoreboard::node, scoreboard::total_length, and scoreboard::total_specificity.

Referenced by new_find_extension().

{
   /* if this extension is marked as deleted, then skip this -- if it never shows
      on the scoreboard, it will never be found, nor will halt the traversal. */
   if (deleted)
      return;
   board->total_specificity = spec;
   board->total_length = length;
   board->exten = exten;
   board->last_char = last;
   board->node = node;
#ifdef NEED_DEBUG_HERE
   ast_log(LOG_NOTICE,"Scoreboarding (LONGER) %s, len=%d, score=%d\n", exten->exten, length, spec);
#endif
}

static void wait_for_hangup	(	struct ast_channel *	chan,
		const void *	data
	)		[static]

Definition at line 10932 of file pbx.c.

References ast_frfree, ast_read(), ast_safe_sleep(), ast_strlen_zero(), ast_waitfor(), and f.

Referenced by pbx_builtin_busy(), and pbx_builtin_congestion().

{
   int res;
   struct ast_frame *f;
   double waitsec;
   int waittime;

   if (ast_strlen_zero(data) || (sscanf(data, "%30lg", &waitsec) != 1) || (waitsec < 0))
      waitsec = -1;
   if (waitsec > -1) {
      waittime = waitsec * 1000.0;
      ast_safe_sleep(chan, waittime);
   } else do {
      res = ast_waitfor(chan, -1);
      if (res < 0)
         return;
      f = ast_read(chan);
      if (f)
         ast_frfree(f);
   } while(f);
}

static int write_escalates

(

const struct ast_custom_function *

acf

)

[static]

Returns true if given custom function escalates privileges on write.

Parameters:

acf	Custom function to query.

Returns:

True (non-zero) if writes escalate privileges.

False (zero) if writes just write.

Definition at line 3995 of file pbx.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, and AST_RWLIST_UNLOCK.

Referenced by is_write_allowed().

                                                                  {
   int res = 0;
   struct ast_custom_escalating_function *cur_escalation;

   AST_RWLIST_RDLOCK(&escalation_root);
   AST_RWLIST_TRAVERSE(&escalation_root, cur_escalation, list) {
      if (cur_escalation->acf == acf) {
         res = cur_escalation->write_escalates;
         break;
      }
   }
   AST_RWLIST_UNLOCK(&escalation_root);
   return res;
}

---

Variable Documentation

struct acf_root acf_root [static]

struct apps apps [static]

int autofallthrough = 1 [static]

Definition at line 1317 of file pbx.c.

Referenced by pbx_set_autofallthrough().

struct ast_app_option background_opts[128] = { [ 's' ] = { .flag = (1 << 0) }, [ 'n' ] = { .flag = (1 << 1) }, [ 'm' ] = { .flag = (1 << 2) }, [ 'p' ] = { .flag = (1 << 3) },} [static]

Definition at line 808 of file pbx.c.

Referenced by pbx_builtin_background().

struct pbx_builtin builtins[] [static]

Referenced by load_pbx(), and unload_pbx().

ast_mutex_t conlock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, 1 } [static]

Lock for the ast_context list.

Note:

This lock MUST be recursive, or a deadlock on reload may result. See https://issues.asterisk.org/view.php?id=17643

Definition at line 1391 of file pbx.c.

Referenced by ast_rdlock_contexts(), ast_unlock_contexts(), and ast_wrlock_contexts().

ast_mutex_t context_merge_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, 1 } [static]

Lock to hold off restructuring of hints by ast_merge_contexts_and_delete.

Definition at line 1396 of file pbx.c.

Referenced by ast_merge_contexts_and_delete(), handle_presencechange(), and handle_statechange().

struct ast_context* contexts [static]

Definition at line 1382 of file pbx.c.

Referenced by ast_context_find_or_create(), ast_merge_contexts_and_delete(), and ast_walk_contexts().

struct ast_hashtab* contexts_table = NULL [static]

Definition at line 1383 of file pbx.c.

Referenced by ast_merge_contexts_and_delete().

int countcalls [static]

Definition at line 1327 of file pbx.c.

Referenced by ast_active_calls().

const char* const days[] [static]

Definition at line 9257 of file pbx.c.

Referenced by ast_build_timing().

struct ast_event_sub* device_state_sub [static]

Subscription for device state change events.

Definition at line 1322 of file pbx.c.

struct escalation_root escalation_root [static]

struct ast_custom_function exception_function [static]

Initial value:

 {
   .name = "EXCEPTION",
   .read = acf_exception_read,
}

Definition at line 3763 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

struct ast_datastore_info exception_store_info [static]

Initial value:

 {
   .type = "EXCEPTION",
   .destroy = exception_store_free,
}

Definition at line 3695 of file pbx.c.

Referenced by acf_exception_read(), and raise_exception().

int extenpatternmatchnew = 0 [static]

Definition at line 1318 of file pbx.c.

Referenced by pbx_set_extenpatternmatchnew().

struct ast_taskprocessor* extension_state_tps [static]

Definition at line 821 of file pbx.c.

struct cfextension_states extension_states[] [static]

Referenced by ast_extension_state2str().

struct ast_threadstorage extensionstate_buf = { .once = PTHREAD_ONCE_INIT , .key_init = __init_extensionstate_buf , .custom_init = NULL , } [static]

Definition at line 824 of file pbx.c.

Referenced by ast_extension_state2(), and extension_presence_state_helper().

struct varshead globals = AST_LIST_HEAD_NOLOCK_INIT_VALUE [static]

Definition at line 1315 of file pbx.c.

Referenced by pbx_builtin_pushvar_helper(), and pbx_builtin_setvar_helper().

ast_rwlock_t globalslock = { PTHREAD_RWLOCK_INITIALIZER , NULL, 1 } [static]

Definition at line 1314 of file pbx.c.

Referenced by ast_str_retrieve_variable(), handle_show_globals(), pbx_builtin_clear_globals(), pbx_builtin_getvar_helper(), pbx_builtin_pushvar_helper(), and pbx_builtin_setvar_helper().

struct ast_threadstorage hintdevice_data = { .once = PTHREAD_ONCE_INIT , .key_init = __init_hintdevice_data , .custom_init = NULL , } [static]

Definition at line 995 of file pbx.c.

Referenced by add_hintdevice().

struct ao2_container* hintdevices [static]

Container for hint devices.

Definition at line 1006 of file pbx.c.

struct ao2_container* hints [static]

Note:

When holding this container's lock, do _not_ do anything that will cause conlock to be taken, unless you _already_ hold it. The ast_merge_contexts_and_delete function will take the locks in conlock/hints order, so any other paths that require both locks must also take them in that order.

Definition at line 1411 of file pbx.c.

Referenced by lua_register_hints(), and pvalExtenSetHints().

struct ast_data_handler hints_data_provider [static]

Initial value:

 {
   .version = AST_DATA_HANDLER_VERSION,
   .get = hints_data_provider_get
}

Definition at line 11977 of file pbx.c.

int live_dangerously [static]

Set to true (non-zero) to globally allow all dangerous dialplan functions to run.

Definition at line 829 of file pbx.c.

Referenced by ast_readconfig().

ast_mutex_t maxcalllock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, 1 } [static]

Definition at line 1326 of file pbx.c.

Referenced by decrease_call_count(), and increase_call_count().

const char* const months[] [static]

Definition at line 9269 of file pbx.c.

Referenced by ast_build_timing().

char* overrideswitch = NULL [static]

Definition at line 1319 of file pbx.c.

Referenced by handle_cli_dialplan_save().

struct ast_cli_entry pbx_cli[] [static]

Definition at line 8615 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

struct ast_data_entry pbx_data_providers[] [static]

Initial value:

 {
   AST_DATA_ENTRY("asterisk/core/hints", &hints_data_provider),
}

Definition at line 11982 of file pbx.c.

Referenced by load_pbx().

struct ast_event_sub* presence_state_sub [static]

Subscription for presence state change events.

Definition at line 1324 of file pbx.c.

struct ast_app_option resetcdr_opts[128] = { [ 'w' ] = { .flag = AST_CDR_FLAG_POSTED }, [ 'a' ] = { .flag = AST_CDR_FLAG_LOCKED }, [ 'v' ] = { .flag = AST_CDR_FLAG_KEEP_VARS }, [ 'e' ] = { .flag = AST_CDR_FLAG_POST_ENABLE },} [static]

Definition at line 11075 of file pbx.c.

Referenced by pbx_builtin_resetcdr().

struct ao2_container* statecbs [static]

Definition at line 1413 of file pbx.c.

int stateid = 1 [static]

Definition at line 1402 of file pbx.c.

struct ast_threadstorage switch_data = { .once = PTHREAD_ONCE_INIT , .key_init = __init_switch_data , .custom_init = NULL , } [static]

Definition at line 823 of file pbx.c.

Referenced by pbx_find_extension().

struct switches switches [static]

struct ast_custom_function testtime_function [static]

Initial value:

 {
   .name = "TESTTIME",
   .write = testtime_write,
}

Definition at line 11169 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

struct ast_threadstorage thread_inhibit_escalations_tl = { .once = PTHREAD_ONCE_INIT , .key_init = __init_thread_inhibit_escalations_tl , .custom_init = NULL , } [static]

Definition at line 829 of file pbx.c.

Referenced by ast_thread_inhibit_escalations(), and thread_inhibits_escalations().

int totalcalls [static]

Definition at line 1328 of file pbx.c.

Referenced by ast_processed_calls(), and timing_read().

struct ast_app_option waitexten_opts[128] = { [ 'm' ] = { .flag = (1 << 0) , .arg_index = 0 + 1 }, [ 'd' ] = { .flag = (1 << 1) , .arg_index = 0 + 1 },} [static]

Definition at line 816 of file pbx.c.

Referenced by pbx_builtin_waitexten().