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/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/hashtab.h"
#include "asterisk/module.h"
#include "asterisk/indications.h"
#include "asterisk/taskprocessor.h"
#include "asterisk/xmldoc.h"
#include "asterisk/astobj2.h"
#include "asterisk/stasis_channels.h"
#include "asterisk/dial.h"
#include "asterisk/vector.h"
#include "pbx_private.h"

Include dependency graph for pbx.c:

Go to the source code of this file.

Data Structures
struct	ast_autohint
	Structure for dial plan autohints. More...
struct	ast_context
	ast_context: An extension context 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_state_cb
	ast_state_cb: An extension state notify register item More...
struct	cfextension_states
struct	dialplan_counters
	Counters for the show dialplan manager command. More...
struct	match_char
	match_char: forms a syntax tree for quick matching of extension patterns More...
struct	pattern_node
struct	pbx_exception
struct	pbx_outgoing
	Structure which contains information about an outgoing dial. More...
struct	scoreboard
struct	store_hint
struct	store_hints

Macros
#define	ADVANCE(s)   candidate_exten_advance(s)
#define	BITS_PER   8 /* Number of bits per unit (byte). */
#define	EXT_DATA_SIZE   8192
#define	HASH_EXTENHINT_SIZE   563
#define	HINTDEVICE_DATA_LENGTH   16
#define	INC_DST_OVERFLOW_CHECK
#define	MAX_EXTENBUF_SIZE   512
#define	MORE(s)   (*candidate_exten_advance(s))
#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_HARDTRAN   3
#define	VAR_NORMAL   1
#define	VAR_SOFTTRAN   2

Functions
void	__ast_context_destroy (struct ast_context *list, struct ast_hashtab *contexttab, struct ast_context *con, const char *registrar)
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 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	action_extensionstatelist (struct mansession *s, const struct message *m)
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. More...
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. More...
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. More...
int	ast_add_extension (const char *context, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar)
	Add and extension to an extension context. More...
int	ast_add_extension2 (struct ast_context *con, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar, const char *registrar_file, int registrar_line)
	Main interface to add extensions to the list for out context. More...
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, const char *registrar_file, int registrar_line, int lock_context)
	Same as ast_add_extension2() but controls the context locking. More...
int	ast_add_extension2_nolock (struct ast_context *con, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar, const char *registrar_file, int registrar_line)
	Same as ast_add_extension2, but assumes you have already locked context. More...
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. More...
int	ast_async_goto (struct ast_channel *chan, const char *context, const char *exten, int priority)
	Set the channel to next execute the specified dialplan location. More...
int	ast_async_goto_by_name (const char *channame, const char *context, const char *exten, int priority)
	Set the channel to next execute the specified dialplan location. More...
int	ast_async_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_async_parseable_goto (struct ast_channel *chan, const char *goto_string)
int	ast_canmatch_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Looks for a valid matching extension. More...
static int	ast_change_hint (struct ast_exten *oe, struct ast_exten *ne)
	Change hint for an extension. More...
int	ast_context_add_ignorepat (const char *context, const char *value, const char *registrar)
	Add an ignorepat. More...
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. More...
int	ast_context_add_include2 (struct ast_context *con, const char *value, const char *registrar)
	Add a context include. More...
int	ast_context_add_switch (const char *context, const char *sw, const char *data, int eval, const char *registrar)
	Add a switch. More...
int	ast_context_add_switch2 (struct ast_context *con, const char *value, const char *data, int eval, const char *registrar)
	Adds a switch (first param is a ast_context) More...
void	ast_context_destroy (struct ast_context *con, const char *registrar)
	Destroy a context (matches the specified context or ANY context if NULL) More...
int	ast_context_destroy_by_name (const char *context, const char *registrar)
	Destroy a context by name. More...
struct ast_context *	ast_context_find (const char *name)
	Find a context. More...
struct ast_context *	ast_context_find_or_create (struct ast_context **extcontexts, struct ast_hashtab *exttable, const char *name, const char *registrar)
	Register a new context or find an existing one. More...
int	ast_context_ignorepats_count (const struct ast_context *con)
const struct ast_ignorepat *	ast_context_ignorepats_get (const struct ast_context *con, int idx)
int	ast_context_includes_count (const struct ast_context *con)
const struct ast_include *	ast_context_includes_get (const struct ast_context *con, int idx)
int	ast_context_remove_extension (const char *context, const char *extension, int priority, const char *registrar)
	Simply remove extension from context. More...
int	ast_context_remove_extension2 (struct ast_context *con, const char *extension, int priority, const char *registrar, int already_locked)
	This functionc locks given context, search for the right extension and fires out all peer in this extensions with given priority. If priority is set to 0, all peers are removed. After that, unlock context and return. More...
int	ast_context_remove_extension_callerid (const char *context, const char *extension, int priority, const char *callerid, int 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)
	Remove an ignorepat. More...
int	ast_context_remove_ignorepat2 (struct ast_context *con, const char *ignorepat, const char *registrar)
int	ast_context_remove_include (const char *context, const char *include, const char *registrar)
	Remove 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 ... More...
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. More...
int	ast_context_remove_switch (const char *context, const char *sw, const char *data, const char *registrar)
	Remove a switch. More...
int	ast_context_remove_switch2 (struct ast_context *con, const char *sw, const char *data, const char *registrar)
	This function locks given context, removes switch, unlock context and return. More...
void	ast_context_set_autohints (struct ast_context *con, int enabled)
	Enable or disable autohints support on a context. More...
int	ast_context_switches_count (const struct ast_context *con)
const struct ast_sw *	ast_context_switches_get (const struct ast_context *con, int idx)
int	ast_context_verify_includes (struct ast_context *con)
	Verifies includes in an ast_contect structure. More...
enum ast_extension_states	ast_devstate_to_extenstate (enum ast_device_state devstate)
	Map devstate to an extension state. More...
int	ast_exists_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Determine whether an extension exists. More...
int	ast_explicit_goto (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_extension_close (const char *pattern, const char *data, int needmore)
int	ast_extension_cmp (const char *a, const char *b)
	Determine if one extension should match before another. More...
int	ast_extension_match (const char *pattern, const char *extension)
	Determine if a given extension matches a given pattern (in NXX format) More...
int	ast_extension_state (struct ast_channel *c, const char *context, const char *exten)
	Check extension state for an extension by using hint. More...
static int	ast_extension_state2 (struct ast_exten *e, struct ao2_container *device_state_info)
	Check state of extension by using hints. More...
const char *	ast_extension_state2str (int extension_state)
	Return extension_state as string. More...
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. More...
int	ast_extension_state_add_destroy (const char *context, const char *exten, ast_state_cb_type change_cb, ast_state_cb_destroy_type destroy_cb, void *data)
	Add watcher for extension states with destructor. More...
int	ast_extension_state_add_destroy_extended (const char *context, const char *exten, ast_state_cb_type change_cb, ast_state_cb_destroy_type destroy_cb, void *data)
	Add watcher for extended extension states with destructor. More...
int	ast_extension_state_add_extended (const char *context, const char *exten, ast_state_cb_type change_cb, void *data)
	Add watcher for extended extension states. More...
int	ast_extension_state_del (int id, ast_state_cb_type change_cb)
	Deletes a state change watcher by ID. More...
int	ast_extension_state_extended (struct ast_channel *c, const char *context, const char *exten, struct ao2_container **device_state_info)
	Check extended extension state for an extension by using hint. More...
int	ast_findlabel_extension (struct ast_channel *c, const char *context, const char *exten, const char *label, const char *callerid)
	Find the priority of an extension that has the specified label. More...
int	ast_findlabel_extension2 (struct ast_channel *c, struct ast_context *con, const char *exten, const char *label, const char *callerid)
	Find the priority of an extension that has the specified label. More...
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)
int	ast_get_extension_data (char *buf, int bufsize, struct ast_channel *c, const char *context, const char *exten, int priority)
	Fill a string buffer with the data at a dialplan extension. More...
const char *	ast_get_extension_label (struct ast_exten *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)
const char *	ast_get_extension_registrar_file (struct ast_exten *e)
	Get name of configuration file used by registrar to register this extension. More...
int	ast_get_extension_registrar_line (struct ast_exten *e)
	Get line number of configuration file used by registrar to register this extension. More...
int	ast_get_hint (char *hint, int hintsize, char *name, int namesize, struct ast_channel *c, const char *context, const char *exten)
	Get hint for channel. More...
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 More...
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. More...
int	ast_hint_presence_state (struct ast_channel *c, const char *context, const char *exten, char **subtype, char **message)
	Uses hint and presence state callback to get the presence state of an extension. More...
int	ast_ignore_pattern (const char *context, const char *pattern)
	Checks to see if a number should be ignored. More...
int	ast_matchmore_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Looks to see if adding anything to this extension might match something. (exists ^ canmatch) More...
void	ast_merge_contexts_and_delete (struct ast_context **extcontexts, struct ast_hashtab *exttable, const char *registrar)
	Merge the temporary contexts into a global contexts list and delete from the global list the ones that are being added. More...
int	ast_parseable_goto (struct ast_channel *chan, const char *goto_string)
void	ast_pbx_h_exten_run (struct ast_channel *chan, const char *context)
	Run the h exten from the given context. More...
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, const struct ast_assigned_ids *assignedids)
	Synchronously or asynchronously make an outbound call and execute an application on the channel. More...
int	ast_pbx_outgoing_app_predial (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *app, const char *appdata, int *reason, int synchronous, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel, const struct ast_assigned_ids *assignedids, const char *predial_callee)
int	ast_pbx_outgoing_exten (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *context, const char *exten, int priority, int *reason, int synchronous, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel, int early_media, const struct ast_assigned_ids *assignedids)
	Synchronously or asynchronously make an outbound call and send it to a particular extension. More...
int	ast_pbx_outgoing_exten_predial (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *context, const char *exten, int priority, int *reason, int synchronous, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel, int early_media, const struct ast_assigned_ids *assignedids, const char *predial_callee)
enum ast_pbx_result	ast_pbx_run (struct ast_channel *c)
	Execute the PBX in the current thread. More...
enum ast_pbx_result	ast_pbx_run_args (struct ast_channel *c, struct ast_pbx_args *args)
	Execute the PBX in the current thread. More...
enum ast_pbx_result	ast_pbx_start (struct ast_channel *c)
	Create a new thread and start the PBX. More...
int	ast_processed_calls (void)
	Retrieve the total number of calls processed through the PBX since last restart. More...
int	ast_rdlock_context (struct ast_context *con)
	Read locks a given context. More...
int	ast_rdlock_contexts (void)
	Read locks the context list. More...
static int	ast_remove_hint (struct ast_exten *e)
	Remove hint from extension. More...
int	ast_spawn_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid, int *found, int combined_find_spawn)
	Launch a new extension (i.e. new stack) More...
int	ast_str_get_hint (struct ast_str **hint, ssize_t hintsize, struct ast_str **name, ssize_t namesize, struct ast_channel *c, const char *context, const char *exten)
	Get hint for channel. More...
int	ast_unlock_context (struct ast_context *con)
int	ast_unlock_contexts (void)
	Unlocks contexts. More...
struct ast_exten *	ast_walk_context_extensions (struct ast_context *con, struct ast_exten *exten)
const struct ast_ignorepat *	ast_walk_context_ignorepats (const struct ast_context *con, const struct ast_ignorepat *ip)
const struct ast_include *	ast_walk_context_includes (const struct ast_context *con, const struct ast_include *inc)
const struct ast_sw *	ast_walk_context_switches (const struct ast_context *con, const struct ast_sw *sw)
struct ast_context *	ast_walk_contexts (struct ast_context *con)
struct ast_exten *	ast_walk_extension_priorities (struct ast_exten *exten, struct ast_exten *priority)
int	ast_wrlock_context (struct ast_context *con)
	Write locks a given context. More...
int	ast_wrlock_contexts (void)
	Write locks the context list. More...
static int	autohint_cmp (void *obj, void *arg, int flags)
static int	autohint_hash_cb (const void *obj, const int flags)
static const char *	candidate_exten_advance (const char *str)
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. More...
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' More...
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	context_table_create_autohints (struct ast_hashtab *table)
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 (void *unused, struct stasis_subscription *sub, struct stasis_message *msg)
static void	device_state_info_dt (void *obj)
static void	device_state_notify_callbacks (struct ast_hint *hint, struct ast_str **hint_app)
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. More...
static int	ext_fluff_count (const char *exten)
static unsigned int	ext_strncpy (char *dst, const char *src, size_t dst_size, int nofluff)
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, More...
static struct ast_context *	find_context_locked (const char *context)
	lookup for a context with a given name, More...
static int	find_hint_by_cb_id (void *obj, void *arg, int flags)
	Find Hint by callback id. More...
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 char *	handle_debug_dialplan (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	Send ack once. More...
static int	handle_hint_change_message_type (struct stasis_message *msg, enum ast_state_cb_update_reason reason)
static char *	handle_set_extenpatternmatchnew (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_show_dialplan (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 More...
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 More...
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 *obj, void *arg, void *data, int flags)
static int	increase_call_count (const struct ast_channel *c)
	Increase call count for channel. More...
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)
int	load_pbx (void)
static void	manager_dpsendack (struct mansession *s, const struct message *m)
	Send ack once. More...
static int	manager_show_dialplan (struct mansession *s, const struct message *m)
	Manager listing of dial plan. More...
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, const struct ast_include *rinclude, int includecount, const char *includes[])
	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. More...
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)
int	pbx_checkcondition (const char *condition)
	Evaluate a condition. More...
static void	pbx_destroy (struct ast_pbx *p)
static enum ast_control_frame_type	pbx_dial_reason (enum ast_dial_result dial_result, int cause)
	Attempt to convert disconnect cause to old originate reason. More...
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: More...
struct ast_exten *	pbx_find_extension (struct ast_channel *chan, struct ast_context *bypass, struct pbx_find_info *q, const char *context, const char *exten, int priority, const char *label, const char *callerid, enum ext_match_t action)
static int	pbx_outgoing_attempt (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *context, const char *exten, int priority, 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, int early_media, const struct ast_assigned_ids *assignedids, const char *predial_callee)
static void	pbx_outgoing_destroy (void *obj)
	Destructor for outgoing structure. More...
static void *	pbx_outgoing_exec (void *data)
	Internal function which dials an outgoing leg and sends it to a provided extension or application. More...
static void	pbx_outgoing_state_callback (struct ast_dial *dial)
	Internal dialing state callback which causes early media to trigger an answer. More...
int	pbx_parse_location (struct ast_channel *chan, char **contextp, char **extenp, char **prip, int *ipri, int *mode, char *rest)
	Parses a dialplan location into context, extension, priority. More...
static int	pbx_parseable_goto (struct ast_channel *chan, const char *goto_string, int async)
int	pbx_set_autofallthrough (int newval)
int	pbx_set_extenpatternmatchnew (int newval)
void	pbx_set_overrideswitch (const char *newval)
static void	pbx_shutdown (void)
static void *	pbx_thread (void *data)
static void	presence_state_cb (void *unused, struct stasis_subscription *sub, struct stasis_message *msg)
static void	presence_state_notify_callbacks (struct ast_hint *hint, struct ast_str **hint_app, struct ast_presence_state_message *presence_state)
static void	print_autohint_key (void *v_obj, void *where, ao2_prnt_fn *prnt)
static void	print_ext (struct ast_exten *e, char *buf, int buflen)
	helper function to print an extension More...
static void	print_hintdevices_key (void *v_obj, void *where, ao2_prnt_fn *prnt)
static void	print_hints_key (void *v_obj, void *where, ao2_prnt_fn *prnt)
static void	print_statecbs_key (void *v_obj, void *where, ao2_prnt_fn *prnt)
static int	publish_hint_change (struct ast_hint *hint, struct ast_exten *ne)
	Publish a hint changed event More...
static int	publish_hint_remove (struct ast_hint *hint)
	Publish a hint removed event More...
int	raise_exception (struct ast_channel *chan, const char *reason, int priority)
static int	remove_hintdevice (struct ast_hint *hint)
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, const struct ast_include *rinclude, int includecount, const char *includes[])
static void	show_dialplan_helper_extension_output (int fd, char *buf1, char *buf2, struct ast_exten *exten)
	Writes CLI output of a single extension for show dialplan. More...
	STASIS_MESSAGE_TYPE_DEFN_LOCAL (hint_change_message_type)
	STASIS_MESSAGE_TYPE_DEFN_LOCAL (hint_remove_message_type)
static int	statecbs_cmp (void *obj, void *arg, int flags)
static int	testtime_write (struct ast_channel *chan, const char *cmd, char *var, const char *value)
static struct ast_exten *	trie_find_next_match (struct match_char *node)
static void	unload_pbx (void)
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)
void	wait_for_hangup (struct ast_channel *chan, const void *data)

Variables
static int	autofallthrough = 1
static struct ao2_container *	autohints
	Container for autohint contexts. More...
static ast_mutex_t	conlock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }
	Lock for the ast_context list. More...
static ast_mutex_t	context_merge_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }
	Lock to hold off restructuring of hints by ast_merge_contexts_and_delete. More...
static struct ast_context *	contexts
static struct ast_hashtab *	contexts_table = NULL
static int	countcalls
static struct stasis_subscription *	device_state_sub
	Subscription for device state change events. More...
static struct ast_custom_function	exception_function
static const struct ast_datastore_info	exception_store_info
static int	extenpatternmatchnew = 0
static const 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 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. More...
static struct ao2_container *	hints
static ast_mutex_t	maxcalllock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }
static char *	overrideswitch = NULL
static struct ast_cli_entry	pbx_cli []
static struct stasis_subscription *	presence_state_sub
	Subscription for presence state change events. More...
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 ast_custom_function	testtime_function
static int	totalcalls

Detailed Description

Core PBX routines.

Author

Mark Spencer marks.nosp@m.ter@.nosp@m.digiu.nosp@m.m.co.nosp@m.m

Definition in file pbx.c.

Macro Definition Documentation

ADVANCE

#define ADVANCE

(

s

)

candidate_exten_advance(s)

Definition at line 1234 of file pbx.c.

BITS_PER

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

EXT_DATA_SIZE

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

HASH_EXTENHINT_SIZE

#define HASH_EXTENHINT_SIZE   563

Definition at line 365 of file pbx.c.

HINTDEVICE_DATA_LENGTH

#define HINTDEVICE_DATA_LENGTH   16

Definition at line 358 of file pbx.c.

INC_DST_OVERFLOW_CHECK

#define INC_DST_OVERFLOW_CHECK

MAX_EXTENBUF_SIZE

#define MAX_EXTENBUF_SIZE   512

Definition at line 1662 of file pbx.c.

MORE

#define MORE

(

s

)

(*candidate_exten_advance(s))

Definition at line 1233 of file pbx.c.

NEW_MATCHER_CHK_MATCH

#define NEW_MATCHER_CHK_MATCH

NEW_MATCHER_RECURSE

#define NEW_MATCHER_RECURSE

SAY_STUBS

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

Definition at line 57 of file pbx.c.

STATUS_NO_CONTEXT

#define STATUS_NO_CONTEXT   1

Definition at line 2464 of file pbx.c.

STATUS_NO_EXTENSION

#define STATUS_NO_EXTENSION   2

Definition at line 2465 of file pbx.c.

STATUS_NO_LABEL

#define STATUS_NO_LABEL   4

Definition at line 2467 of file pbx.c.

STATUS_NO_PRIORITY

#define STATUS_NO_PRIORITY   3

Definition at line 2466 of file pbx.c.

STATUS_SUCCESS

#define STATUS_SUCCESS   5

Definition at line 2468 of file pbx.c.

SWITCH_DATA_LENGTH

#define SWITCH_DATA_LENGTH   256

Definition at line 219 of file pbx.c.

VAR_HARDTRAN

#define VAR_HARDTRAN   3

Definition at line 223 of file pbx.c.

VAR_NORMAL

#define VAR_NORMAL   1

Definition at line 221 of file pbx.c.

VAR_SOFTTRAN

#define VAR_SOFTTRAN   2

Definition at line 222 of file pbx.c.

Function Documentation

__ast_context_destroy()

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

Definition at line 8056 of file pbx.c.

{
    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;
            int idx;
 
            /* remove any ignorepats whose registrar matches */
            for (idx = ast_context_ignorepats_count(tmp) - 1; idx >= 0; idx--) {
                struct ast_ignorepat *ip = AST_VECTOR_GET(&tmp->ignorepats, idx);
 
                if (!strcmp(ast_get_ignorepat_registrar(ip), registrar)) {
                    AST_VECTOR_REMOVE_ORDERED(&tmp->ignorepats, idx);
                    ignorepat_free(ip);
                }
            }
            /* remove any includes whose registrar matches */
            for (idx = ast_context_includes_count(tmp) - 1; idx >= 0; idx--) {
                struct ast_include *i = AST_VECTOR_GET(&tmp->includes, idx);
 
                if (!strcmp(ast_get_include_registrar(i), registrar)) {
                    AST_VECTOR_REMOVE_ORDERED(&tmp->includes, idx);
                    include_free(i);
                }
            }
            /* remove any switches whose registrar matches */
            for (idx = ast_context_switches_count(tmp) - 1; idx >= 0; idx--) {
                struct ast_sw *sw = AST_VECTOR_GET(&tmp->alts, idx);
 
                if (!strcmp(ast_get_switch_registrar(sw), registrar)) {
                    AST_VECTOR_REMOVE_ORDERED(&tmp->alts, idx);
                    sw_free(sw);
                }
            }
 
            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;
 
                    /*
                     * If the extension could not be removed from the root_table due to
                     * a loaded PBX app, it can exist here but have its peer_table be
                     * destroyed due to a previous pass through this function.
                     */
                    if (!exten_item->peer_table) {
                        continue;
                    }
 
                    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(5, "Remove %s/%s/%d, registrar=%s; con=%s(%p); con->root=%p\n",
                                 tmp->name, prio_item->name, 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 && !ast_context_ignorepats_count(tmp) && !ast_context_includes_count(tmp) && !ast_context_switches_count(tmp)) {
                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;
    }
}

References __ast_internal_context_destroy(), ast_context_ignorepats_count(), ast_context_includes_count(), ast_context_remove_extension_callerid2(), ast_context_switches_count(), ast_copy_string(), ast_debug, ast_free, ast_get_ignorepat_registrar(), ast_get_include_registrar(), ast_get_switch_registrar(), ast_hashtab_end_traversal(), ast_hashtab_next(), ast_hashtab_remove_this_object(), ast_hashtab_start_traversal, AST_MAX_EXTENSION, ast_unlock_context(), AST_VECTOR_GET, AST_VECTOR_REMOVE_ORDERED, ast_verb, ast_wrlock_context(), ast_exten::cidmatch, contexts, ast_exten::exten, ignorepat_free(), include_free(), ast_exten::matchcid, ast_exten::name, ast_context::name, ast_context::next, ast_sw::next, NULL, ast_exten::peer_table, ast_exten::priority, ast_exten::registrar, registrar, ast_context::root_table, sw_free(), and tmp().

Referenced by ast_context_destroy().

__ast_goto_if_exists()

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

static

Definition at line 8760 of file pbx.c.

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

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

Referenced by ast_async_goto_if_exists(), and ast_goto_if_exists().

__ast_internal_context_destroy()

static void __ast_internal_context_destroy ( struct ast_context *  con )

static

Definition at line 8015 of file pbx.c.

{
    struct ast_exten *e, *el, *en;
    struct ast_context *tmp = con;
 
    /* Free includes */
    AST_VECTOR_CALLBACK_VOID(&tmp->includes, include_free);
    AST_VECTOR_FREE(&tmp->includes);
 
    /* Free ignorepats */
    AST_VECTOR_CALLBACK_VOID(&tmp->ignorepats, ignorepat_free);
    AST_VECTOR_FREE(&tmp->ignorepats);
 
    /* Free switches */
    AST_VECTOR_CALLBACK_VOID(&tmp->alts, sw_free);
    AST_VECTOR_FREE(&tmp->alts);
 
    /* 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);
 
    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_free(tmp);
}

References ast_free, ast_hashtab_destroy(), ast_rwlock_destroy, AST_VECTOR_CALLBACK_VOID, AST_VECTOR_FREE, destroy_exten(), destroy_pattern_tree(), el, ignorepat_free(), include_free(), ast_exten::next, NULL, ast_exten::peer, sw_free(), and tmp().

Referenced by __ast_context_destroy(), and ast_merge_contexts_and_delete().

__ast_pbx_run()

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

{
    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;
    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 AST_PBX_FAILED;
    }
 
    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_lock(c);
                ast_channel_callid_set(c, callid);
                ast_channel_unlock(c);
            }
        }
        ast_callid_threadassoc_add(callid);
        callid = 0;
    }
 
    ast_channel_pbx_set(c, pbx);
    /* Set reasonable defaults */
    ast_channel_pbx(c)->rtimeoutms = 10000;
    ast_channel_pbx(c)->dtimeoutms = 5000;
 
    ast_channel_lock(c);
    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);
    ast_channel_unlock(c);
 
    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);
    }
 
    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. */
                }
                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 = indicate_congestion(c, "10");
                else if (!strcasecmp(status, "CHANUNAVAIL"))
                    res = indicate_congestion(c, "10");
                else if (!strcasecmp(status, "BUSY"))
                    res = indicate_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;
                    }
                }
            }
        }
    }
 
    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_channel_lock(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 */
    ast_channel_unlock(c);
    pbx_destroy(ast_channel_pbx(c));
    ast_channel_pbx_set(c, NULL);
 
    if (!args || !args->no_hangup_chan) {
        ast_hangup(c);
    }
 
    return AST_PBX_SUCCESS;
}

References args, ast_callid_threadassoc_add(), ast_calloc, ast_channel_caller(), ast_channel_callid(), ast_channel_callid_set(), 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_FAILED, ast_pbx_h_exten_run(), ast_pbx_hangup_handler_run(), AST_PBX_INCOMPLETE, AST_PBX_SUCCESS, 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, autofallthrough, c, collect_digits(), digit, ast_pbx::dtimeoutms, error(), indicate_busy(), indicate_congestion(), LOG_WARNING, NULL, 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().

__init_extensionstate_buf()

static void __init_extensionstate_buf ( void  )

static

Definition at line 229 of file pbx.c.

{

__init_hintdevice_data()

static void __init_hintdevice_data ( void  )

static

Definition at line 359 of file pbx.c.

{

__init_switch_data()

static void __init_switch_data ( void  )

static

Definition at line 228 of file pbx.c.

{

_extension_match_core()

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

static

Definition at line 2223 of file pbx.c.

{
    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 */
    }
}

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

Referenced by extension_match_core().

acf_exception_read()

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

static

Definition at line 2832 of file pbx.c.

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

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

action_extensionstatelist()

static int action_extensionstatelist ( struct mansession *  s, const struct message *  m  )

static

Definition at line 8344 of file pbx.c.

{
    const char *action_id = astman_get_header(m, "ActionID");
    struct ast_hint *hint;
    struct ao2_iterator it_hints;
    int hint_count = 0;
 
    if (!hints) {
        astman_send_error(s, m, "No dialplan hints are available");
        return 0;
    }
 
    astman_send_listack(s, m, "Extension Statuses will follow", "start");
 
    ao2_lock(hints);
    it_hints = ao2_iterator_init(hints, 0);
    for (; (hint = ao2_iterator_next(&it_hints)); ao2_ref(hint, -1)) {
 
        ao2_lock(hint);
 
        /* Ignore pattern matching hints; they are stored in the
         * hints container but aren't real from the perspective of
         * an AMI user
         */
        if (hint->exten->exten[0] == '_') {
            ao2_unlock(hint);
            continue;
        }
 
        ++hint_count;
 
        astman_append(s, "Event: ExtensionStatus\r\n");
        if (!ast_strlen_zero(action_id)) {
            astman_append(s, "ActionID: %s\r\n", action_id);
        }
        astman_append(s,
           "Exten: %s\r\n"
           "Context: %s\r\n"
           "Hint: %s\r\n"
           "Status: %d\r\n"
           "StatusText: %s\r\n\r\n",
           hint->exten->exten,
           hint->exten->parent->name,
           hint->exten->app,
           hint->laststate,
           ast_extension_state2str(hint->laststate));
        ao2_unlock(hint);
    }
 
    ao2_iterator_destroy(&it_hints);
    ao2_unlock(hints);
 
    astman_send_list_complete_start(s, m, "ExtensionStateListComplete", hint_count);
    astman_send_list_complete_end(s);
 
    return 0;
}

References ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_exten::app, ast_extension_state2str(), ast_strlen_zero(), astman_append(), astman_get_header(), astman_send_error(), astman_send_list_complete_end(), astman_send_list_complete_start(), astman_send_listack(), ast_exten::exten, ast_hint::exten, ast_hint::laststate, ast_context::name, and ast_exten::parent.

Referenced by load_pbx().

add_exten_to_pattern_tree()

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

static

Definition at line 1663 of file pbx.c.

{
    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[MAX_EXTENBUF_SIZE];
    volatile size_t required_space = strlen(e1->exten) + 1;
    struct pattern_node pat_node[2];
 
    if (e1->matchcid) {
        required_space += (strlen(e1->cidmatch) + 2 /* '/' + NULL */);
        if (required_space > MAX_EXTENBUF_SIZE) {
            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 {
        if (required_space > MAX_EXTENBUF_SIZE) {
            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;
        }
        ast_copy_string(extenbuf, e1->exten, required_space);
    }
 
#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->name, e1->name);
                }
                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->name, e1->name);
                }
                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;
}

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

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

add_hintdevice()

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

static

add hintdevice structure and link it into the container.

Definition at line 557 of file pbx.c.

{
    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 = ast_str_buffer(str);
 
    /* Spit on '&' and ',' to handle presence hints as well */
    while ((cur = strsep(&parse, "&,"))) {
        char *device_name;
 
        devicelength = strlen(cur);
        if (!devicelength) {
            continue;
        }
 
        device_name = ast_strdup(cur);
        if (!device_name) {
            return -1;
        }
 
        device = ao2_t_alloc(sizeof(*device) + devicelength, hintdevice_destroy,
            "allocating a hintdevice structure");
        if (!device) {
            ast_free(device_name);
            return -1;
        }
        strcpy(device->hintdevice, cur);
        ao2_ref(hint, +1);
        device->hint = hint;
        if (AST_VECTOR_APPEND(&hint->devices, device_name)) {
            ast_free(device_name);
            ao2_ref(device, -1);
            return -1;
        }
        ao2_t_link(hintdevices, device, "Linking device into hintdevice container.");
        ao2_t_ref(device, -1, "hintdevice is linked so we can unref");
    }
 
    return 0;
}

References ao2_ref, ao2_t_alloc, ao2_t_link, ao2_t_ref, ast_free, ast_str_buffer(), ast_str_set(), ast_str_thread_get(), ast_strdup, AST_VECTOR_APPEND, ast_hint::devices, ast_hintdevice::hint, ast_hintdevice::hintdevice, hintdevice_data, hintdevice_destroy(), hintdevices, str, and strsep().

Referenced by ast_add_hint(), and ast_change_hint().

add_pattern_node()

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

Definition at line 1464 of file pbx.c.

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

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

Referenced by add_exten_to_pattern_tree().

add_priority()

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

{
    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->name, tmp->name)) {
                ast_log(LOG_WARNING,
                    "Extension '%s' priority %d in '%s', label '%s' already in use at aliased extension '%s' priority %d\n",
                    tmp->name, tmp->priority, con->name, tmp->label, e->name, e->priority);
            } else {
                ast_log(LOG_WARNING,
                    "Extension '%s' priority %d in '%s', label '%s' already in use at priority %d\n",
                    tmp->name, 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->name, tmp->name)) {
                ast_log(LOG_WARNING,
                    "Unable to register extension '%s' priority %d in '%s', already in use by aliased extension '%s'\n",
                    tmp->name, tmp->priority, con->name, e->name);
            } else {
                ast_log(LOG_WARNING,
                    "Unable to register extension '%s' priority %d in '%s', already in use\n",
                    tmp->name, tmp->priority, con->name);
            }
 
            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;
}

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, el, ast_exten::label, LOG_ERROR, LOG_WARNING, ast_exten::name, ast_context::name, ast_exten::next, NULL, ast_exten::peer, ast_exten::peer_label_table, ast_exten::peer_table, ast_exten::priority, PRIORITY_HINT, replace(), ast_context::root, ast_context::root_table, tmp(), and match_char::x.

Referenced by ast_add_extension2_lockopt().

alloc_device_state_info()

static struct ao2_container * alloc_device_state_info ( void  )

static

Definition at line 3076 of file pbx.c.

{
    return ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_NOLOCK, 0, NULL, NULL);
}

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_container_alloc_list, and NULL.

Referenced by ast_extension_state_extended(), and device_state_notify_callbacks().

already_in_tree()

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

static

Definition at line 1402 of file pbx.c.

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

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

Referenced by add_exten_to_pattern_tree().

ast_active_calls()

int ast_active_calls

(

void

)

Retrieve the number of active calls.

Definition at line 4760 of file pbx.c.

{
    return countcalls;
}

References countcalls.

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

ast_add_extension()

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

Add and extension to an extension context.

Parameters

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

Note

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

Return values

0	success
-1	failure

Definition at line 6928 of file pbx.c.

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

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

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

ast_add_extension2()

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

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

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

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

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

ast_add_extension2_lockopt()

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, const char *  registrar_file, int  registrar_line, 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 7283 of file pbx.c.

{
    /*
     * 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];
    int exten_fluff;
    int callerid_fluff;
 
    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);
        /* We always need to deallocate 'data' on failure */
        if (datad) {
            datad(data);
        }
        return -1;
    }
 
    /* If we are adding a hint evaluate in variables and global variables */
    if (priority == PRIORITY_HINT && strstr(application, "${") && extension[0] != '_') {
        int inhibited;
        struct ast_channel *c = ast_dummy_channel_alloc();
 
        if (c) {
            ast_channel_exten_set(c, extension);
            ast_channel_context_set(c, con->name);
        }
 
        /*
         * We can allow dangerous functions when adding a hint since
         * altering dialplan is itself a privileged activity.  Otherwise,
         * we could never execute dangerous functions.
         */
        inhibited = ast_thread_inhibit_escalations_swap(0);
        pbx_substitute_variables_helper(c, application, expand_buf, sizeof(expand_buf));
        if (0 < inhibited) {
            ast_thread_inhibit_escalations();
        }
 
        application = expand_buf;
        if (c) {
            ast_channel_unref(c);
        }
    }
 
    if (priority == PRIORITY_HINT) {
        /* Fluff in a hint is fine. This prevents the removal of dashes from dynamically
         * created hints during a reload. */
        exten_fluff = 0;
    } else {
        exten_fluff = ext_fluff_count(extension);
    }
 
    callerid_fluff = callerid ? ext_fluff_count(callerid) : 0;
 
    length = sizeof(struct ast_exten);
    length += strlen(extension) + 1;
    if (exten_fluff) {
        length += strlen(extension) + 1 - exten_fluff;
    }
    length += strlen(application) + 1;
    if (label) {
        length += strlen(label) + 1;
    }
    if (callerid) {
        length += strlen(callerid) + 1;
        if (callerid_fluff) {
            length += strlen(callerid) + 1 - callerid_fluff;
        }
    } else {
        length ++;  /* just the '\0' */
    }
    if (registrar_file) {
        length += strlen(registrar_file) + 1;
    }
 
    /* Be optimistic:  Build the extension structure first */
    tmp = ast_calloc(1, length);
    if (!tmp) {
        /* We always need to deallocate 'data' on failure */
        if (datad) {
            datad(data);
        }
        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->name = p;
    p += ext_strncpy(p, extension, strlen(extension) + 1, 0);
    if (exten_fluff) {
        tmp->exten = p;
        p += ext_strncpy(p, extension, strlen(extension) + 1 - exten_fluff, 1);
    } else {
        /* no fluff, we don't need a copy. */
        tmp->exten = tmp->name;
    }
    tmp->priority = priority;
    tmp->cidmatch_display = 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, 0);
        if (callerid_fluff) {
            tmp->cidmatch = p;
            p += ext_strncpy(p, callerid, strlen(callerid) + 1 - callerid_fluff, 1);
        }
        tmp->matchcid = AST_EXT_MATCHCID_ON;
    } else {
        *p++ = '\0';
        tmp->matchcid = AST_EXT_MATCHCID_OFF;
    }
 
    if (registrar_file) {
        tmp->registrar_file = p;
        strcpy(p, registrar_file);
        p += strlen(registrar_file) + 1;
    } else {
        tmp->registrar_file = NULL;
    }
 
    tmp->app = p;
    strcpy(p, application);
    tmp->parent = con;
    tmp->data = data;
    tmp->datad = datad;
    tmp->registrar = registrar;
    tmp->registrar_line = registrar_line;
 
    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. */
        ext_strncpy(dummy_name, tmp->exten, sizeof(dummy_name), 1);
        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 (res < 0) {
            if (con->pattern_tree) {
                struct match_char *x = add_exten_to_pattern_tree(con, tmp, 1);
 
                if (x->exten) {
                    x->deleted = 1;
                    x->exten = 0;
                }
 
                ast_hashtab_remove_this_object(con->root_table, tmp);
            }
 
            if (tmp->datad) {
                tmp->datad(tmp->data);
                /* if you free this, null it out */
                tmp->data = NULL;
            }
 
            ast_free(tmp);
        }
        if (lock_context) {
            ast_unlock_context(con);
        }
        if (res < 0) {
            errno = EEXIST;
            return -1;
        }
    } 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;
        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 (el) {  /* there is another exten already in this context */
            el->next = 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;
        }
        if (label) {
            ast_hashtab_insert_safe(tmp->peer_label_table, tmp);
        }
        ast_hashtab_insert_safe(tmp->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 (DEBUG_ATLEAST(1)) {
        if (tmp->matchcid == AST_EXT_MATCHCID_ON) {
            ast_log(LOG_DEBUG, "Added extension '%s' priority %d (CID match '%s') to %s (%p)\n",
                tmp->name, tmp->priority, tmp->cidmatch_display, con->name, con);
        } else {
            ast_log(LOG_DEBUG, "Added extension '%s' priority %d to %s (%p)\n",
                tmp->name, tmp->priority, con->name, con);
        }
    }
 
    return 0;
}

References add_exten_to_pattern_tree(), add_priority(), ast_add_hint(), ast_calloc, ast_channel_context_set(), ast_channel_exten_set(), ast_channel_unref, ast_dummy_channel_alloc, AST_EXT_MATCHCID_OFF, AST_EXT_MATCHCID_ON, ast_free, ast_hashtab_create, ast_hashtab_insert_safe, ast_hashtab_lookup(), ast_hashtab_newsize_java(), ast_hashtab_remove_this_object(), ast_hashtab_resize_java(), ast_log, ast_strlen_zero(), ast_thread_inhibit_escalations(), ast_thread_inhibit_escalations_swap(), ast_unlock_context(), ast_wrlock_context(), c, ast_exten::cidmatch, ast_exten::data, ast_exten::datad, DEBUG_ATLEAST, el, errno, ext_cmp(), ext_fluff_count(), 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_DEBUG, LOG_ERROR, ast_exten::matchcid, ast_context::name, ast_exten::next, NULL, ast_context::pattern_tree, pbx_substitute_variables_helper(), priority, PRIORITY_HINT, registrar, ast_exten::registrar_file, ast_exten::registrar_line, replace(), ast_context::root, ast_context::root_table, tmp(), VAR_BUF_SIZE, and match_char::x.

Referenced by ast_add_extension2(), ast_add_extension2_nolock(), and ast_add_extension_nolock().

ast_add_extension2_nolock()

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

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

Since

12.0.0

Note

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

Definition at line 7266 of file pbx.c.

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

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

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

ast_add_extension_nolock()

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

{
    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, NULL, 0, 1);
    }
 
    return ret;
}

References ast_add_extension2_lockopt(), c, voicemailpwcheck::context, ast_context::data, find_context(), NULL, priority, registrar, and replace().

Referenced by ast_merge_contexts_and_delete().

ast_add_hint()

static int ast_add_hint ( struct ast_exten *  e )

static

Add hint to hint list, check initial extension state.

Definition at line 3978 of file pbx.c.

{
    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;
    }
    AST_VECTOR_INIT(&hint_new->devices, 8);
 
    /* Initialize new hint. */
    hint_new->callbacks = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_MUTEX, 0, NULL, hint_id_cmp);
    if (!hint_new->callbacks) {
        ao2_ref(hint_new, -1);
        return -1;
    }
    hint_new->exten = e;
    if (strstr(e->app, "${") && e->exten[0] == '_') {
        /* The hint is dynamic and hasn't been evaluated yet */
        hint_new->laststate = AST_DEVICE_INVALID;
        hint_new->last_presence_state = AST_PRESENCE_INVALID;
    } else {
        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;
        }
    }
 
    /* 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)));
    }
 
    /* if not dynamic */
    if (!(strstr(e->app, "${") && e->exten[0] == '_')) {
        struct ast_state_cb *state_cb;
        struct ao2_iterator cb_iter;
 
        /* 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,
                ast_get_context_name(ast_get_extension_context(e)),
                ast_get_extension_name(e),
                state_cb->data,
                AST_HINT_UPDATE_DEVICE,
                hint_new,
                NULL);
        }
        ao2_iterator_destroy(&cb_iter);
    }
    ao2_unlock(hints);
    ao2_ref(hint_new, -1);
 
    return 0;
}

References add_hintdevice(), ao2_alloc, AO2_ALLOC_OPT_LOCK_MUTEX, ao2_container_alloc_list, ao2_find, ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_link, ao2_lock, ao2_ref, ao2_unlock, ast_exten::app, ast_debug, AST_DEVICE_INVALID, ast_extension_state2(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), AST_HINT_UPDATE_DEVICE, ast_log, AST_PRESENCE_INVALID, AST_VECTOR_INIT, ast_hint::callbacks, ast_state_cb::change_cb, ast_state_cb::data, destroy_hint(), ast_hint::devices, execute_state_callback(), ast_exten::exten, 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, LOG_WARNING, NULL, and statecbs.

Referenced by add_priority(), and ast_add_extension2_lockopt().

ast_async_goto()

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

Set the channel to next execute the specified dialplan location.

See also

ast_async_parseable_goto, ast_async_goto_if_exists

Note

Do NOT hold any channel locks when calling this function.

Definition at line 6969 of file pbx.c.

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

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

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

ast_async_goto_by_name()

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

Set the channel to next execute the specified dialplan location.

Definition at line 7002 of file pbx.c.

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

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

ast_async_goto_if_exists()

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

Note

This function will handle locking the channel as needed.

Definition at line 8786 of file pbx.c.

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

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

ast_async_parseable_goto()

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

Note

This function will handle locking the channel as needed.

Definition at line 8871 of file pbx.c.

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

References pbx_parseable_goto().

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

ast_canmatch_extension()

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

Looks for a valid matching extension.

Parameters

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

Note

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

Returns

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

Definition at line 4190 of file pbx.c.

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

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

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

ast_change_hint()

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

static

Change hint for an extension.

Definition at line 4092 of file pbx.c.

{
    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);
        ast_mutex_unlock(&context_merge_lock);
        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);
 
    publish_hint_change(hint, ne);
 
    ao2_ref(hint, -1);
 
    return 0;
}

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_mutex_unlock, context_merge_lock, ast_hint::exten, LOG_WARNING, OBJ_UNLINK, publish_hint_change(), and remove_hintdevice().

Referenced by add_priority().

ast_context_add_ignorepat()

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

Add an ignorepat.

Parameters

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

Adds an ignore pattern to a particular context.

Return values

0	on success
-1	on failure

Definition at line 6835 of file pbx.c.

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

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

Referenced by handle_cli_dialplan_add_ignorepat().

ast_context_add_ignorepat2()

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

Definition at line 6848 of file pbx.c.

{
    struct ast_ignorepat *ignorepat = ignorepat_alloc(value, registrar);
    int idx;
 
    if (!ignorepat) {
        return -1;
    }
 
    ast_wrlock_context(con);
    for (idx = 0; idx < ast_context_ignorepats_count(con); idx++) {
        const struct ast_ignorepat *i = ast_context_ignorepats_get(con, idx);
 
        if (!strcasecmp(ast_get_ignorepat_name(i), value)) {
            /* Already there */
            ast_unlock_context(con);
            ignorepat_free(ignorepat);
            errno = EEXIST;
            return -1;
        }
    }
    if (AST_VECTOR_APPEND(&con->ignorepats, ignorepat)) {
        ignorepat_free(ignorepat);
        ast_unlock_context(con);
        return -1;
    }
    ast_unlock_context(con);
 
    return 0;
}

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

Referenced by ast_context_add_ignorepat(), and context_merge_incls_swits_igps_other_registrars().

ast_context_add_include()

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

Add a context include.

Parameters

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

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

Return values

0	on success
-1	on error

Definition at line 6664 of file pbx.c.

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

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

Referenced by AST_TEST_DEFINE(), and handle_cli_dialplan_add_include().

ast_context_add_include2()

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

Add a context include.

Adds an include taking a struct ast_context as the first parameter

Note

See ast_context_add_include for information on arguments

Definition at line 6684 of file pbx.c.

{
    struct ast_include *new_include;
    int idx;
 
    /* allocate new include structure ... */
    new_include = include_alloc(value, registrar);
    if (!new_include) {
        return -1;
    }
 
    ast_wrlock_context(con);
 
    /* ... go to last include and check if context is already included too... */
    for (idx = 0; idx < ast_context_includes_count(con); idx++) {
        const struct ast_include *i = ast_context_includes_get(con, idx);
 
        if (!strcasecmp(ast_get_include_name(i), ast_get_include_name(new_include))) {
            include_free(new_include);
            ast_unlock_context(con);
            errno = EEXIST;
            return -1;
        }
    }
 
    /* ... include new context into context list, unlock, return */
    if (AST_VECTOR_APPEND(&con->includes, new_include)) {
        include_free(new_include);
        ast_unlock_context(con);
        return -1;
    }
    ast_debug(1, "Including context '%s' in context '%s'\n",
        ast_get_include_name(new_include), ast_get_context_name(con));
 
    ast_unlock_context(con);
 
    return 0;
}

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

Referenced by ast_context_add_include(), and context_merge_incls_swits_igps_other_registrars().

ast_context_add_switch()

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

Add a switch.

Parameters

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

This function registers a switch with the asterisk switch architecture

Return values

0	on success
-1	on failure

Definition at line 6729 of file pbx.c.

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

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

ast_context_add_switch2()

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)

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

{
    int idx;
    struct ast_sw *new_sw;
 
    /* allocate new sw structure ... */
    if (!(new_sw = sw_alloc(value, data, eval, registrar))) {
        return -1;
    }
 
    /* ... try to lock this context ... */
    ast_wrlock_context(con);
 
    /* ... go to last sw and check if context is already swd too... */
    for (idx = 0; idx < ast_context_switches_count(con); idx++) {
        const struct ast_sw *i = ast_context_switches_get(con, idx);
 
        if (!strcasecmp(ast_get_switch_name(i), ast_get_switch_name(new_sw)) &&
            !strcasecmp(ast_get_switch_data(i), ast_get_switch_data(new_sw))) {
            sw_free(new_sw);
            ast_unlock_context(con);
            errno = EEXIST;
            return -1;
        }
    }
 
    /* ... sw new context into context list, unlock, return */
    if (AST_VECTOR_APPEND(&con->alts, new_sw)) {
        sw_free(new_sw);
        ast_unlock_context(con);
        return -1;
    }
 
    ast_verb(3, "Including switch '%s/%s' in context '%s'\n",
        ast_get_switch_name(new_sw), ast_get_switch_data(new_sw), ast_get_context_name(con));
 
    ast_unlock_context(con);
 
    return 0;
}

References ast_context::alts, ast_context_switches_count(), ast_context_switches_get(), ast_get_context_name(), ast_get_switch_data(), ast_get_switch_name(), ast_unlock_context(), AST_VECTOR_APPEND, ast_verb, ast_wrlock_context(), ast_sw::data, errno, ast_sw::eval, registrar, sw_alloc(), sw_free(), and value.

Referenced by ast_context_add_switch(), and context_merge_incls_swits_igps_other_registrars().

ast_context_destroy()

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

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

Parameters

con	context to destroy
registrar	who registered it

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

Definition at line 8221 of file pbx.c.

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

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

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

ast_context_destroy_by_name()

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

Destroy a context by name.

Parameters

context	Name of the context to destroy
registrar	who registered it

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

Return values

-1	context not found
0	Success

Definition at line 8205 of file pbx.c.

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

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

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

ast_context_find()

struct ast_context * ast_context_find

(

const char *

name

)

Find a context.

Parameters

name	name of the context to find

Will search for the context with the given name.

Returns

the ast_context on success, NULL on failure.

Definition at line 2439 of file pbx.c.

{
    struct ast_context *tmp;
    struct ast_context item = {
        .name = name,
    };
 
    if (!name) {
        return NULL;
    }
    ast_rdlock_contexts();
    if (contexts_table) {
        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;
}

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

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

ast_context_find_or_create()

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

Register a new context or find an existing one.

Parameters

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

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

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

Returns

NULL on failure, and an ast_context structure on success

Definition at line 6149 of file pbx.c.

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

References ast_assert, ast_calloc, ast_debug, ast_hashtab_compare_contexts(), ast_hashtab_create, ast_hashtab_hash_contexts(), ast_hashtab_insert_immediate, ast_hashtab_insert_safe, ast_hashtab_lookup(), ast_hashtab_newsize_java(), ast_hashtab_resize_java(), ast_log, ast_rdlock_contexts(), ast_rwlock_init, ast_unlock_contexts(), AST_VECTOR_INIT, ast_wrlock_contexts(), contexts, contexts_table, local_contexts, LOG_ERROR, name, ast_context::name, NULL, registrar, and tmp().

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

ast_context_ignorepats_count()

int ast_context_ignorepats_count

(

const struct ast_context *

con

)

Definition at line 8722 of file pbx.c.

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

References AST_VECTOR_SIZE, and ast_context::ignorepats.

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

ast_context_ignorepats_get()

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

Definition at line 8727 of file pbx.c.

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

References AST_VECTOR_GET, and ast_context::ignorepats.

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

ast_context_includes_count()

int ast_context_includes_count

(

const struct ast_context *

con

)

Definition at line 8679 of file pbx.c.

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

References AST_VECTOR_SIZE, and ast_context::includes.

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

ast_context_includes_get()

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

Definition at line 8684 of file pbx.c.

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

References AST_VECTOR_GET, and ast_context::includes.

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

ast_context_remove_extension()

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

Simply remove extension from context.

Note

This function will lock conlock.

Definition at line 4948 of file pbx.c.

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

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

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

ast_context_remove_extension2()

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

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

Note

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

Definition at line 4978 of file pbx.c.

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

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

Referenced by add_extension(), and add_hints().

ast_context_remove_extension_callerid()

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

Definition at line 4953 of file pbx.c.

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

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

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

ast_context_remove_extension_callerid2()

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

Definition at line 4983 of file pbx.c.

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

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

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

ast_context_remove_ignorepat()

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

Remove an ignorepat.

Parameters

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

This removes the given ignorepattern

Return values

0	on success
-1	on failure

Definition at line 6795 of file pbx.c.

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

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

Referenced by handle_cli_dialplan_remove_ignorepat().

ast_context_remove_ignorepat2()

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

Definition at line 6808 of file pbx.c.

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

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

Referenced by ast_context_remove_ignorepat().

ast_context_remove_include()

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

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

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

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

Referenced by handle_cli_dialplan_remove_include().

ast_context_remove_include2()

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

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

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

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

Referenced by ast_context_remove_include().

ast_context_remove_switch()

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

Remove a switch.

Note

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

Definition at line 4894 of file pbx.c.

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

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

ast_context_remove_switch2()

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

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

Note

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

Definition at line 4916 of file pbx.c.

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

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

Referenced by ast_context_remove_switch().

ast_context_set_autohints()

void ast_context_set_autohints	(	struct ast_context *	con,
		int	enabled
	)

Enable or disable autohints support on a context.

Parameters

con	pointer to the context
enabled	whether autohints are enabled

Definition at line 6230 of file pbx.c.

{
    con->autohints = enabled;
}

References ast_context::autohints, and enabled.

Referenced by pbx_load_config().

ast_context_switches_count()

int ast_context_switches_count

(

const struct ast_context *

con

)

Definition at line 8634 of file pbx.c.

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

References ast_context::alts, and AST_VECTOR_SIZE.

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

ast_context_switches_get()

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

Definition at line 8639 of file pbx.c.

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

References ast_context::alts, and AST_VECTOR_GET.

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

ast_context_verify_includes()

int ast_context_verify_includes

(

struct ast_context *

con

)

Verifies includes in an ast_contect structure.

Parameters

con	context in which to verify the includes

Return values

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

Definition at line 8732 of file pbx.c.

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

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

Referenced by pbx_load_module().

ast_devstate_to_extenstate()

enum ast_extension_states ast_devstate_to_extenstate

(

enum ast_device_state

devstate

)

Map devstate to an extension state.

Parameters

[in]

devstate

device state

Returns

the extension state mapping.

Definition at line 3006 of file pbx.c.

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

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

Referenced by ast_extension_state3(), and AST_TEST_DEFINE().

ast_exists_extension()

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

Determine whether an extension exists.

Parameters

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

Note

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

Returns

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

Definition at line 4175 of file pbx.c.

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

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

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

ast_explicit_goto()

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

Note

This function will handle locking the channel as needed.

Definition at line 6945 of file pbx.c.

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

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(), ast_test_flag, voicemailpwcheck::context, and priority.

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

ast_extension_close()

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

Definition at line 2432 of file pbx.c.

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

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

Referenced by lua_find_extension(), and realtime_switch_common().

ast_extension_cmp()

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

Determine if one extension should match before another.

Parameters

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

Checks whether or extension a should match before extension b

Return values

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

Definition at line 2197 of file pbx.c.

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

References a, b, and ext_cmp().

Referenced by lua_extension_cmp().

ast_extension_match()

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

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

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

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

ast_extension_state()

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

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

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

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

ast_extension_state2()

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

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

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

ast_extension_state2str()

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

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

References ARRAY_LEN, extension_states, and cfextension_states::text.

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

ast_extension_state3()

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

static

Definition at line 3081 of file pbx.c.

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

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(), state, and strsep().

Referenced by ast_extension_state2(), and device_state_notify_callbacks().

ast_extension_state_add()

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

Add watcher for extension states.

Parameters

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

Note

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

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

Return values

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

Definition at line 3823 of file pbx.c.

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

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

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

ast_extension_state_add_destroy()

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

Add watcher for extension states with destructor.

Since

1.8.9

10.1.0

Parameters

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

Note

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

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

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

Return values

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

Definition at line 3817 of file pbx.c.

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

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

ast_extension_state_add_destroy_extended()

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

Add watcher for extended extension states with destructor.

Since

11

Parameters

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

Note

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

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

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

Return values

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

Definition at line 3829 of file pbx.c.

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

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

Referenced by subscription_established().

ast_extension_state_add_extended()

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

Add watcher for extended extension states.

Since

11

Parameters

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

Note

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

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

Return values

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

Definition at line 3835 of file pbx.c.

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

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

ast_extension_state_del()

int ast_extension_state_del	(	int	id,
		ast_state_cb_type	change_cb
	)

Deletes a state change watcher by ID.

Parameters

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

Return values

0	success
-1	failure

Definition at line 3856 of file pbx.c.

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

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

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

ast_extension_state_extended()

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

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

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

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

Referenced by exten_state_data_alloc().

ast_findlabel_extension()

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

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

Parameters

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

Note

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

Return values

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

Definition at line 4180 of file pbx.c.

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

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

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

ast_findlabel_extension2()

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

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

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

Referenced by pbx_load_config().

ast_get_context_name()

const char * ast_get_context_name

(

struct ast_context *

con

)

Definition at line 8499 of file pbx.c.

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

References ast_context::name, and NULL.

Referenced by ast_add_hint(), ast_change_hint(), ast_context_add_include2(), ast_context_add_switch2(), ast_context_remove_include2(), ast_context_remove_switch2(), ast_context_verify_includes(), ast_remove_hint(), complete_show_dialplan_context(), context_merge_incls_swits_igps_other_registrars(), device_state_notify_callbacks(), handle_show_hint(), handle_show_hints(), manager_show_dialplan_helper(), presence_state_notify_callbacks(), print_hintdevices_key(), print_hints_key(), show_debug_helper(), and show_dialplan_helper().

ast_get_context_registrar()

const char * ast_get_context_registrar

(

struct ast_context *

c

)

Definition at line 8527 of file pbx.c.

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

References c, and NULL.

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

ast_get_extension_app()

const char * ast_get_extension_app

(

struct ast_exten *

e

)

Definition at line 8557 of file pbx.c.

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

References ast_exten::app, and NULL.

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

ast_get_extension_app_data()

void * ast_get_extension_app_data

(

struct ast_exten *

e

)

Definition at line 8562 of file pbx.c.

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

References ast_exten::data, and NULL.

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

ast_get_extension_cidmatch()

const char * ast_get_extension_cidmatch

(

struct ast_exten *

e

)

Definition at line 8552 of file pbx.c.

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

References ast_exten::cidmatch_display, and NULL.

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

ast_get_extension_context()

struct ast_context * ast_get_extension_context

(

struct ast_exten *

exten

)

Definition at line 8504 of file pbx.c.

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

References NULL, and ast_exten::parent.

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

ast_get_extension_data()

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

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

Parameters

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

Return values

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

Definition at line 8567 of file pbx.c.

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

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

Referenced by eval_exten_read().

ast_get_extension_label()

const char * ast_get_extension_label

(

struct ast_exten *

exten

)

Definition at line 8514 of file pbx.c.

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

References ast_exten::label, and NULL.

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

ast_get_extension_matchcid()

int ast_get_extension_matchcid

(

struct ast_exten *

e

)

Definition at line 8547 of file pbx.c.

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

References ast_exten::matchcid.

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

ast_get_extension_name()

const char * ast_get_extension_name

(

struct ast_exten *

exten

)

Definition at line 8509 of file pbx.c.

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

References ast_exten::name, and NULL.

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

ast_get_extension_priority()

int ast_get_extension_priority

(

struct ast_exten *

exten

)

Definition at line 8519 of file pbx.c.

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

References ast_exten::priority.

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

ast_get_extension_registrar()

const char * ast_get_extension_registrar

(

struct ast_exten *

e

)

Definition at line 8532 of file pbx.c.

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

References NULL, and ast_exten::registrar.

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

ast_get_extension_registrar_file()

const char * ast_get_extension_registrar_file

(

struct ast_exten *

e

)

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

Return values

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

Definition at line 8537 of file pbx.c.

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

References NULL, and ast_exten::registrar_file.

Referenced by show_dialplan_helper_extension_output().

ast_get_extension_registrar_line()

int ast_get_extension_registrar_line

(

struct ast_exten *

e

)

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

Return values

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

Definition at line 8542 of file pbx.c.

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

References ast_exten::registrar_line.

Referenced by show_dialplan_helper_extension_output().

ast_get_hint()

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

Get hint for channel.

If an extension hint exists, return non-zero.

Definition at line 4137 of file pbx.c.

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

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

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

ast_goto_if_exists()

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

Note

This function will handle locking the channel as needed.

Definition at line 8781 of file pbx.c.

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

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

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

ast_hashtab_compare_contexts()

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

hashtable functions for contexts

Definition at line 688 of file pbx.c.

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

References bc, and ast_context::name.

Referenced by ast_context_find_or_create().

ast_hashtab_hash_contexts()

unsigned int ast_hashtab_hash_contexts

(

const void *

obj

)

Definition at line 740 of file pbx.c.

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

References ast_hashtab_hash_string(), and ast_context::name.

Referenced by ast_context_find_or_create().

ast_hint_extension()

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

static

Definition at line 2997 of file pbx.c.

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

References ast_hint_extension_nolock(), ast_rdlock_contexts(), ast_unlock_contexts(), c, voicemailpwcheck::context, and ast_exten::exten.

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

ast_hint_extension_nolock()

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

static

Find hint for given extension in context.

Definition at line 2991 of file pbx.c.

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

References c, voicemailpwcheck::context, E_MATCH, NULL, pbx_find_extension(), PRIORITY_HINT, and pbx_find_info::stacklen.

Referenced by ast_hint_extension(), and ast_merge_contexts_and_delete().

ast_hint_presence_state()

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

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

Parameters

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

Note

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

Returns

returns the presence state value.

Definition at line 3226 of file pbx.c.

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

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

Referenced by exten_state_data_alloc().

ast_ignore_pattern()

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

Checks to see if a number should be ignored.

Parameters

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

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

Return values

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

Definition at line 6879 of file pbx.c.

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

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

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

ast_matchmore_extension()

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

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

Parameters

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

Note

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

Returns

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

Definition at line 4195 of file pbx.c.

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

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

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

ast_merge_contexts_and_delete()

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

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

Parameters

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

Definition at line 6426 of file pbx.c.

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

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

Referenced by lua_reload_extensions(), and pbx_load_module().

ast_parseable_goto()

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

Note

This function will handle locking the channel as needed.

Definition at line 8866 of file pbx.c.

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

References pbx_parseable_goto().

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

ast_pbx_h_exten_run()

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

Run the h exten from the given context.

Since

11.0

Parameters

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

Definition at line 4205 of file pbx.c.

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

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

Referenced by __ast_pbx_run(), and ast_bridge_setup_after_goto().

ast_pbx_init()

int ast_pbx_init

(

void

)

Provided by pbx.c

Definition at line 8989 of file pbx.c.

{
    hints = ao2_container_alloc_hash(AO2_ALLOC_OPT_LOCK_MUTEX, 0,
        HASH_EXTENHINT_SIZE, hint_hash, NULL, hint_cmp);
    if (hints) {
        ao2_container_register("hints", hints, print_hints_key);
    }
    hintdevices = ao2_container_alloc_hash(AO2_ALLOC_OPT_LOCK_MUTEX, 0,
        HASH_EXTENHINT_SIZE, hintdevice_hash_cb, NULL, hintdevice_cmp_multiple);
    if (hintdevices) {
        ao2_container_register("hintdevices", hintdevices, print_hintdevices_key);
    }
    /* This is protected by the context_and_merge lock */
    autohints = ao2_container_alloc_hash(AO2_ALLOC_OPT_LOCK_NOLOCK, 0, HASH_EXTENHINT_SIZE,
        autohint_hash_cb, NULL, autohint_cmp);
    if (autohints) {
        ao2_container_register("autohints", autohints, print_autohint_key);
    }
    statecbs = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_MUTEX, 0, NULL, statecbs_cmp);
    if (statecbs) {
        ao2_container_register("statecbs", statecbs, print_statecbs_key);
    }
 
    ast_register_cleanup(pbx_shutdown);
 
    if (STASIS_MESSAGE_TYPE_INIT(hint_change_message_type) != 0) {
        return -1;
    }
    if (STASIS_MESSAGE_TYPE_INIT(hint_remove_message_type) != 0) {
        return -1;
    }
 
    return (hints && hintdevices && autohints && statecbs) ? 0 : -1;
}

References AO2_ALLOC_OPT_LOCK_MUTEX, AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_container_alloc_hash, ao2_container_alloc_list, ao2_container_register(), ast_register_cleanup(), autohint_cmp(), autohint_hash_cb(), autohints, HASH_EXTENHINT_SIZE, hint_cmp(), hint_hash(), hintdevice_cmp_multiple(), hintdevice_hash_cb(), hintdevices, NULL, pbx_shutdown(), print_autohint_key(), print_hintdevices_key(), print_hints_key(), print_statecbs_key(), STASIS_MESSAGE_TYPE_INIT, statecbs, and statecbs_cmp().

Referenced by asterisk_daemon().

ast_pbx_outgoing_app()

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

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

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

Parameters

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

Return values

0	on success
-1	on failure

Definition at line 7980 of file pbx.c.

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

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

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

ast_pbx_outgoing_app_predial()

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

Definition at line 7990 of file pbx.c.

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

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

Referenced by ast_pbx_outgoing_app(), and originate_exec().

ast_pbx_outgoing_exten()

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

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

Parameters

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

Return values

0	on success
-1	on failure

Definition at line 7916 of file pbx.c.

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

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

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

ast_pbx_outgoing_exten_predial()

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

Todo:

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

Definition at line 7926 of file pbx.c.

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

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

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

ast_pbx_run()

enum ast_pbx_result ast_pbx_run

(

struct ast_channel *

c

)

Execute the PBX in the current thread.

Parameters

c	channel to run the pbx on

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

Return values

Zero	on success
non-zero	on failure

Definition at line 4755 of file pbx.c.

{
    return ast_pbx_run_args(c, NULL);
}

References ast_pbx_run_args(), c, and NULL.

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

ast_pbx_run_args()

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

Execute the PBX in the current thread.

Parameters

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

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

Return values

Zero	on success
non-zero	on failure

Definition at line 4735 of file pbx.c.

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

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

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

ast_pbx_start()

enum ast_pbx_result ast_pbx_start

(

struct ast_channel *

c

)

Create a new thread and start the PBX.

Parameters

c	channel to start the pbx on

See also

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

Return values

Zero	on success
non-zero	on failure

Definition at line 4708 of file pbx.c.

{
    pthread_t t;
 
    if (!c) {
        ast_log(LOG_WARNING, "Asked to start thread on NULL channel?\n");
        return AST_PBX_FAILED;
    }
 
    if (!ast_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;
}

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, c, decrease_call_count(), increase_call_count(), LOG_WARNING, NULL, and pbx_thread().

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

ast_processed_calls()

int ast_processed_calls

(

void

)

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

Definition at line 4765 of file pbx.c.

{
    return totalcalls;
}

References totalcalls.

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

ast_rdlock_context()

int ast_rdlock_context

(

struct ast_context *

con

)

Read locks a given context.

Parameters

con	context to lock

Return values

0	on success
-1	on failure

Definition at line 8486 of file pbx.c.

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

References ast_rwlock_rdlock, and ast_context::lock.

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

ast_rdlock_contexts()

int ast_rdlock_contexts

(

void

)

Read locks the context list.

Return values

0	on success
-1	on error

Definition at line 8468 of file pbx.c.

{
    return ast_mutex_lock(&conlock);
}

References ast_mutex_lock, and conlock.

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

ast_remove_hint()

static int ast_remove_hint ( struct ast_exten *  e )

static

Remove hint from extension.

Definition at line 3941 of file pbx.c.

{
    /* 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);
 
    publish_hint_remove(hint);
 
    ao2_ref(hint, -1);
 
    return 0;
}

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, NULL, OBJ_UNLINK, publish_hint_remove(), and remove_hintdevice().

Referenced by destroy_exten().

ast_spawn_extension()

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

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

Parameters

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

This adds a new extension to the asterisk extension list.

Note

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

Return values

0	on success
-1	on failure.

Definition at line 4200 of file pbx.c.

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

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

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

ast_str_get_hint()

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

Get hint for channel.

If an extension hint exists, return non-zero.

Definition at line 4155 of file pbx.c.

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

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

Referenced by ast_str_retrieve_variable().

ast_unlock_context()

int ast_unlock_context

(

struct ast_context *

con

)

Return values

Unlocks

the given context

Parameters

con	context to unlock

Return values

0	on success
-1	on failure

Definition at line 8491 of file pbx.c.

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

References ast_rwlock_unlock, and ast_context::lock.

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

ast_unlock_contexts()

int ast_unlock_contexts

(

void

)

Unlocks contexts.

Return values

0	on success
-1	on failure

Definition at line 8473 of file pbx.c.

{
    return ast_mutex_unlock(&conlock);
}

References ast_mutex_unlock, and conlock.

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

ast_walk_context_extensions()

struct ast_exten * ast_walk_context_extensions	(	struct ast_context *	con,
		struct ast_exten *	exten
	)

Definition at line 8596 of file pbx.c.

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

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

Referenced by manager_show_dialplan_helper(), pbx_find_extension(), show_dialplan_helper(), and unreference_cached_app().

ast_walk_context_ignorepats()

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

Definition at line 8689 of file pbx.c.

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

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

ast_walk_context_includes()

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

Definition at line 8650 of file pbx.c.

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

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

Referenced by context_included().

ast_walk_context_switches()

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

Definition at line 8605 of file pbx.c.

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

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

ast_walk_contexts()

struct ast_context * ast_walk_contexts

(

struct ast_context *

con

)

Definition at line 8591 of file pbx.c.

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

References contexts, and ast_context::next.

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

ast_walk_extension_priorities()

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

Definition at line 8644 of file pbx.c.

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

References ast_exten::exten, and priority.

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

ast_wrlock_context()

int ast_wrlock_context

(

struct ast_context *

con

)

Write locks a given context.

Parameters

con	context to lock

Return values

0	on success
-1	on failure

Definition at line 8481 of file pbx.c.

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

References ast_rwlock_wrlock, and ast_context::lock.

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

ast_wrlock_contexts()

int ast_wrlock_contexts

(

void

)

Write locks the context list.

Return values

0	on success
-1	on error

Definition at line 8463 of file pbx.c.

{
    return ast_mutex_lock(&conlock);
}

References ast_mutex_lock, and conlock.

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

autohint_cmp()

static int autohint_cmp ( void *  obj, void *  arg, int  flags  )

static

Definition at line 481 of file pbx.c.

{
    struct ast_autohint *left = obj;
    struct ast_autohint *right = arg;
    const char *right_key = arg;
    int cmp;
 
    switch (flags & OBJ_SEARCH_MASK) {
    case OBJ_SEARCH_OBJECT:
        right_key = right->context;
        /* Fall through */
    case OBJ_SEARCH_KEY:
        cmp = strcasecmp(left->context, right_key);
        break;
    case OBJ_SEARCH_PARTIAL_KEY:
        /*
        * We could also use a partial key struct containing a length
        * so strlen() does not get called for every comparison instead.
        */
        cmp = strncmp(left->context, right_key, strlen(right_key));
        break;
    default:
        ast_assert(0);
        cmp = 0;
        break;
    }
    return cmp ? 0 : CMP_MATCH | CMP_STOP;
}

References ast_assert, CMP_MATCH, CMP_STOP, ast_autohint::context, OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, OBJ_SEARCH_OBJECT, and OBJ_SEARCH_PARTIAL_KEY.

Referenced by ast_pbx_init().

autohint_hash_cb()

static int autohint_hash_cb ( const void *  obj, const int  flags  )

static

Note

Using the context name for hash

Definition at line 460 of file pbx.c.

{
    const struct ast_autohint *autohint;
    const char *key;
 
    switch (flags & OBJ_SEARCH_MASK) {
    case OBJ_SEARCH_KEY:
        key = obj;
        break;
    case OBJ_SEARCH_OBJECT:
        autohint = obj;
        key = autohint->context;
        break;
    default:
        ast_assert(0);
        return 0;
    }
 
    return ast_str_case_hash(key);
}

References ast_assert, ast_str_case_hash(), ast_autohint::context, OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, and OBJ_SEARCH_OBJECT.

Referenced by ast_pbx_init().

candidate_exten_advance()

static const char * candidate_exten_advance ( const char *  str )

static

Definition at line 1224 of file pbx.c.

{
    str++;
    while (*str == '-') {
        str++;
    }
    return str;
}

References str.

cli_match_char_tree()

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

static

Definition at line 1116 of file pbx.c.

{
    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->name : "", 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->name : "", 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);
}

References ast_cli(), ast_str_alloca, ast_str_buffer(), ast_str_set(), cli_match_char_tree(), and prefix.

Referenced by cli_match_char_tree(), and show_debug_helper().

collect_digits()

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

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

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(), buf, c, digit, ast_pbx::dtimeoutms, NULL, and S_COR.

Referenced by __ast_pbx_run().

compare_char()

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

static

Definition at line 679 of file pbx.c.

{
    const unsigned char *ac = a;
    const unsigned char *bc = b;
 
    return *ac - *bc;
}

References a, b, and bc.

Referenced by get_pattern_node().

complete_core_show_hint()

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

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

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

Referenced by handle_show_hint().

complete_show_dialplan_context()

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

static

Definition at line 5398 of file pbx.c.

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

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

Referenced by handle_debug_dialplan(), and handle_show_dialplan().

context_merge()

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

static

Definition at line 6327 of file pbx.c.

{
    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 */
                    if (new) {
                        new->autohints = context->autohints;
                    }
                }
 
                /* 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->name, prio_item->priority, prio_item->label,
                                          prio_item->matchcid ? prio_item->cidmatch : NULL, prio_item->app, dupdstr, ast_free_ptr, prio_item->registrar,
                                          prio_item->registrar_file, prio_item->registrar_line);
                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->name, 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);
    } else if (new) {
        /* If the context existed but had no extensions, we still want to merge
         * the includes, switches and ignore patterns.
         */
        context_merge_incls_swits_igps_other_registrars(new, context, registrar);
    }
 
    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);
 
        if (new) {
            new->autohints = context->autohints;
        }
 
        /* copy in the includes, switches, and ignorepats */
        context_merge_incls_swits_igps_other_registrars(new, context, registrar);
    }
}

References ast_exten::app, ast_add_extension2(), ast_context_find_or_create(), ast_free_ptr(), ast_hashtab_end_traversal(), ast_hashtab_lookup(), ast_hashtab_next(), ast_hashtab_start_traversal, ast_log, ast_strdup, ast_verb, ast_exten::cidmatch, voicemailpwcheck::context, context_merge_incls_swits_igps_other_registrars(), ast_exten::data, first, ast_exten::label, LOG_ERROR, ast_exten::matchcid, ast_exten::name, NULL, ast_exten::peer_table, ast_exten::priority, ast_exten::registrar, registrar, ast_exten::registrar_file, and ast_exten::registrar_line.

Referenced by ast_merge_contexts_and_delete().

context_merge_incls_swits_igps_other_registrars()

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

static

Definition at line 6252 of file pbx.c.

{
    int idx;
 
    ast_debug(1, "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 (idx = 0; idx < ast_context_includes_count(old); idx++) {
        const struct ast_include *i = ast_context_includes_get(old, idx);
 
        if (!strcmp(ast_get_include_registrar(i), registrar)) {
            continue; /* not mine */
        }
        ast_context_add_include2(new, ast_get_include_name(i), ast_get_include_registrar(i));
    }
 
    /* walk through switches */
    for (idx = 0; idx < ast_context_switches_count(old); idx++) {
        const struct ast_sw *sw = ast_context_switches_get(old, idx);
 
        if (!strcmp(ast_get_switch_registrar(sw), registrar)) {
            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 (idx = 0; idx < ast_context_ignorepats_count(old); idx++) {
        const struct ast_ignorepat *ip = ast_context_ignorepats_get(old, idx);
 
        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));
    }
}

References ast_context_add_ignorepat2(), ast_context_add_include2(), ast_context_add_switch2(), ast_context_ignorepats_count(), ast_context_ignorepats_get(), ast_context_includes_count(), ast_context_includes_get(), ast_context_switches_count(), ast_context_switches_get(), ast_debug, 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(), and registrar.

Referenced by context_merge().

context_table_create_autohints()

static void context_table_create_autohints ( struct ast_hashtab *  table )

static

Set up an autohint placeholder in the hints container

Definition at line 6290 of file pbx.c.

{
    struct ast_context *con;
    struct ast_hashtab_iter *iter;
 
    /* Remove all autohints as the below iteration will recreate them */
    ao2_callback(autohints, OBJ_UNLINK | OBJ_NODATA | OBJ_MULTIPLE, NULL, NULL);
 
    iter = ast_hashtab_start_traversal(table);
    while ((con = ast_hashtab_next(iter))) {
        size_t name_len = strlen(con->name) + 1;
        size_t registrar_len = strlen(con->registrar) + 1;
        struct ast_autohint *autohint;
 
        if (!con->autohints) {
            continue;
        }
 
        autohint = ao2_alloc_options(sizeof(*autohint) + name_len + registrar_len, NULL, AO2_ALLOC_OPT_LOCK_NOLOCK);
        if (!autohint) {
            continue;
        }
 
        ast_copy_string(autohint->context, con->name, name_len);
        autohint->registrar = autohint->context + name_len;
        ast_copy_string(autohint->registrar, con->registrar, registrar_len);
 
        ao2_link(autohints, autohint);
        ao2_ref(autohint, -1);
 
        ast_verb(3, "Enabled autohints support on context '%s'\n", con->name);
    }
    ast_hashtab_end_traversal(iter);
}

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_alloc_options, ao2_callback, ao2_link, ao2_ref, ast_copy_string(), ast_hashtab_end_traversal(), ast_hashtab_next(), ast_hashtab_start_traversal, ast_verb, ast_context::autohints, autohints, ast_autohint::context, ast_context::name, NULL, OBJ_MULTIPLE, OBJ_NODATA, OBJ_UNLINK, ast_context::registrar, ast_autohint::registrar, and table.

Referenced by ast_merge_contexts_and_delete().

create_match_char_tree()

static void create_match_char_tree ( struct ast_context *  con )

static

Definition at line 1770 of file pbx.c.

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

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, and ast_context::root_table.

Referenced by pbx_find_extension().

decrease_call_count()

static void decrease_call_count ( void  )

static

Definition at line 4666 of file pbx.c.

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

References ast_mutex_lock, ast_mutex_unlock, countcalls, and maxcalllock.

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

destroy_exten()

static void destroy_exten ( struct ast_exten *  e )

static

Definition at line 4674 of file pbx.c.

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

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

destroy_hint()

static void destroy_hint ( void *  obj )

static

Definition at line 3903 of file pbx.c.

{
    struct ast_hint *hint = obj;
    int i;
 
    ao2_cleanup(hint->callbacks);
 
    for (i = 0; i < AST_VECTOR_SIZE(&hint->devices); i++) {
        char *device = AST_VECTOR_GET(&hint->devices, i);
        ast_free(device);
    }
    AST_VECTOR_FREE(&hint->devices);
    ast_free(hint->last_presence_subtype);
    ast_free(hint->last_presence_message);
}

References ao2_cleanup, ast_free, AST_VECTOR_FREE, AST_VECTOR_GET, AST_VECTOR_SIZE, ast_hint::callbacks, ast_hint::devices, ast_hint::last_presence_message, and ast_hint::last_presence_subtype.

Referenced by ast_add_hint().

destroy_pattern_tree()

static void destroy_pattern_tree ( struct match_char *  pattern_tree )

static

Definition at line 1793 of file pbx.c.

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

References match_char::alt_char, ast_free, destroy_pattern_tree(), match_char::exten, and match_char::next_char.

Referenced by __ast_internal_context_destroy(), and destroy_pattern_tree().

destroy_state_cb()

static void destroy_state_cb ( void *  doomed )

static

Definition at line 3714 of file pbx.c.

{
    struct ast_state_cb *state_cb = doomed;
 
    if (state_cb->destroy_cb) {
        state_cb->destroy_cb(state_cb->id, state_cb->data);
    }
}

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

Referenced by extension_state_add_destroy().

device_state_cb()

static void device_state_cb ( void *  unused, struct stasis_subscription *  sub, struct stasis_message *  msg  )

static

Definition at line 3584 of file pbx.c.

{
    struct ast_device_state_message *dev_state;
    struct ast_str *hint_app;
    struct ast_hintdevice *device;
    struct ast_hintdevice *cmpdevice;
    struct ao2_iterator *dev_iter;
    struct ao2_iterator auto_iter;
    struct ast_autohint *autohint;
    char *virtual_device;
    char *type;
    char *device_name;
 
    if (handle_hint_change_message_type(msg, AST_HINT_UPDATE_DEVICE)) {
        return;
    }
 
    if (hint_remove_message_type() == stasis_message_type(msg)) {
        /* The extension has already been destroyed */
        struct ast_state_cb *state_cb;
        struct ao2_iterator cb_iter;
        struct ast_hint *hint = stasis_message_data(msg);
 
        ao2_lock(hint);
        hint->laststate = AST_EXTENSION_DEACTIVATED;
        ao2_unlock(hint);
 
        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,
                    hint->context_name,
                    hint->exten_name,
                    state_cb->data,
                    AST_HINT_UPDATE_DEVICE,
                    hint,
                    NULL);
        }
        ao2_iterator_destroy(&cb_iter);
        return;
    }
 
    if (ast_device_state_message_type() != stasis_message_type(msg)) {
        return;
    }
 
    dev_state = stasis_message_data(msg);
    if (dev_state->eid) {
        /* ignore non-aggregate states */
        return;
    }
 
    if (ao2_container_count(hintdevices) == 0 && ao2_container_count(autohints) == 0) {
        /* There are no hints monitoring devices. */
        return;
    }
 
    hint_app = ast_str_create(1024);
    if (!hint_app) {
        return;
    }
 
    cmpdevice = ast_alloca(sizeof(*cmpdevice) + strlen(dev_state->device));
    strcpy(cmpdevice->hintdevice, dev_state->device);
 
    ast_mutex_lock(&context_merge_lock);/* Hold off ast_merge_contexts_and_delete */
 
    /* Initially we find all hints for the device and notify them */
    dev_iter = ao2_t_callback(hintdevices,
        OBJ_SEARCH_OBJECT | OBJ_MULTIPLE,
        hintdevice_cmp_multiple,
        cmpdevice,
        "find devices in container");
    if (dev_iter) {
        for (; (device = ao2_iterator_next(dev_iter)); ao2_t_ref(device, -1, "Next device")) {
            if (device->hint) {
                device_state_notify_callbacks(device->hint, &hint_app);
            }
        }
        ao2_iterator_destroy(dev_iter);
    }
 
    /* Second stage we look for any autohint contexts and if the device is not already in the hints
     * we create it.
     */
    type = ast_strdupa(dev_state->device);
    if (ast_strlen_zero(type)) {
        goto end;
    }
 
    /* Determine if this is a virtual/custom device or a real device */
    virtual_device = strchr(type, ':');
    device_name = strchr(type, '/');
    if (virtual_device && (!device_name || (virtual_device < device_name))) {
        device_name = virtual_device;
    }
 
    /* Invalid device state name - not a virtual/custom device and not a real device */
    if (ast_strlen_zero(device_name)) {
        goto end;
    }
 
    *device_name++ = '\0';
 
    auto_iter = ao2_iterator_init(autohints, 0);
    for (; (autohint = ao2_iterator_next(&auto_iter)); ao2_t_ref(autohint, -1, "Next autohint")) {
        if (ast_get_hint(NULL, 0, NULL, 0, NULL, autohint->context, device_name)) {
            continue;
        }
 
        /* The device has no hint in the context referenced by this autohint so create one */
        ast_add_extension(autohint->context, 0, device_name,
            PRIORITY_HINT, NULL, NULL, dev_state->device,
            ast_strdup(dev_state->device), ast_free_ptr, autohint->registrar);
 
        /* Since this hint was just created there are no watchers, so we don't need to notify anyone */
    }
    ao2_iterator_destroy(&auto_iter);
 
end:
    ast_mutex_unlock(&context_merge_lock);
    ast_free(hint_app);
    return;
}

References 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_add_extension(), ast_alloca, ast_device_state_message_type(), AST_EXTENSION_DEACTIVATED, ast_free, ast_free_ptr(), ast_get_hint(), AST_HINT_UPDATE_DEVICE, ast_mutex_lock, ast_mutex_unlock, ast_str_create, ast_strdup, ast_strdupa, ast_strlen_zero(), autohints, ast_hint::callbacks, ast_state_cb::change_cb, ast_autohint::context, context_merge_lock, ast_hint::context_name, ast_state_cb::data, ast_device_state_message::device, device_state_notify_callbacks(), ast_device_state_message::eid, end, execute_state_callback(), ast_hint::exten_name, handle_hint_change_message_type(), ast_hintdevice::hint, ast_hintdevice::hintdevice, hintdevice_cmp_multiple(), hintdevices, ast_hint::laststate, NULL, OBJ_MULTIPLE, OBJ_SEARCH_OBJECT, PRIORITY_HINT, ast_autohint::registrar, stasis_message_data(), stasis_message_type(), and type.

Referenced by load_pbx().

device_state_info_dt()

static void device_state_info_dt ( void *  obj )

static

Definition at line 3069 of file pbx.c.

{
    struct ast_device_state_info *info = obj;
 
    ao2_cleanup(info->causing_channel);
}

References ao2_cleanup, and sip_to_pjsip::info().

Referenced by ast_extension_state3().

device_state_notify_callbacks()

static void device_state_notify_callbacks ( struct ast_hint *  hint, struct ast_str **  hint_app  )

static

Definition at line 3370 of file pbx.c.

{
    struct ao2_iterator cb_iter;
    struct ast_state_cb *state_cb;
    int state;
    int same_state;
    struct ao2_container *device_state_info;
    int first_extended_cb_call = 1;
    char context_name[AST_MAX_CONTEXT];
    char exten_name[AST_MAX_EXTENSION];
 
    ao2_lock(hint);
    if (!hint->exten) {
        /* The extension has already been destroyed */
        ao2_unlock(hint);
        return;
    }
 
    /*
     * 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);
    same_state = state == hint->laststate;
    if (same_state && (~state & AST_EXTENSION_RINGING)) {
        ao2_cleanup(device_state_info);
        return;
    }
 
    /* Device state changed since last check - notify the watchers. */
    hint->laststate = state;    /* record we saw the change */
 
    /* For general callbacks */
    if (!same_state) {
        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_DEVICE,
                hint,
                NULL);
        }
        ao2_iterator_destroy(&cb_iter);
    }
 
    /* For extension callbacks */
    /* extended callbacks are called when the state changed or when AST_STATE_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);
}

References alloc_device_state_info(), ao2_cleanup, ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_copy_string(), AST_EXTENSION_RINGING, ast_extension_state3(), 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_str_set(), ast_hint::callbacks, ast_state_cb::change_cb, context_name, ast_state_cb::data, execute_state_callback(), ast_hint::exten, exten_name, ast_state_cb::extended, get_device_state_causing_channels(), ast_hint::laststate, NULL, state, and statecbs.

Referenced by device_state_cb(), and handle_hint_change_message_type().

exception_store_free()

static void exception_store_free ( void *  data )

static

Definition at line 2783 of file pbx.c.

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

References ast_free, and ast_string_field_free_memory.

execute_state_callback()

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

{
    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;
    }
 
    res = cb(context, exten, &info, data);
 
    return res;
}

References ao2_lock, ao2_unlock, AST_EXTENSION_REMOVED, ast_strdupa, ast_strlen_zero(), voicemailpwcheck::context, ast_state_cb_info::device_state_info, sip_to_pjsip::info(), ast_hint::last_presence_message, ast_hint::last_presence_state, ast_hint::last_presence_subtype, ast_hint::laststate, and ast_state_cb_info::reason.

Referenced by ast_add_hint(), ast_merge_contexts_and_delete(), device_state_cb(), device_state_notify_callbacks(), and presence_state_notify_callbacks().

ext_cmp()

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

static

Definition at line 2140 of file pbx.c.

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

References ext_cmp_exten(), and ext_cmp_pattern().

Referenced by ast_add_extension2_lockopt(), and ast_extension_cmp().

ext_cmp_exten()

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

static

Definition at line 1890 of file pbx.c.

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

Referenced by _extension_match_core(), and ext_cmp().

ext_cmp_exten_partial()

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

static

Definition at line 1847 of file pbx.c.

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

Referenced by _extension_match_core().

ext_cmp_exten_strlen()

static int ext_cmp_exten_strlen ( const char *  str )

static

Definition at line 1817 of file pbx.c.

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

References len(), and str.

Referenced by _extension_match_core().

ext_cmp_pattern()

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

static

Definition at line 2092 of file pbx.c.

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

References ARRAY_LEN, and ext_cmp_pattern_pos().

Referenced by _extension_match_core(), and ext_cmp().

ext_cmp_pattern_pos()

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

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

References ast_log, BITS_PER, c, end, LOG_WARNING, and NULL.

Referenced by ext_cmp_pattern().

ext_fluff_count()

static int ext_fluff_count ( const char *  exten )

static

Definition at line 2162 of file pbx.c.

{
    int fluff = 0;
 
    if (*exten != '_') {
        /* not a pattern, simple check. */
        while (*exten) {
            if (*exten == '-') {
                fluff++;
            }
            exten++;
        }
 
        return fluff;
    }
 
    /* do pattern check */
    while (*exten) {
        if (*exten == '-') {
            fluff++;
        } else if (*exten == '[') {
            /* skip set, dashes here matter. */
            exten = strchr(exten, ']');
 
            if (!exten) {
                /* we'll end up warning about this later, don't spam logs */
                return fluff;
            }
        }
        exten++;
    }
 
    return fluff;
}

References ast_exten::exten.

Referenced by ast_add_extension2_lockopt().

ext_strncpy()

static unsigned int ext_strncpy ( char *  dst, const char *  src, size_t  dst_size, int  nofluff  )

static

Definition at line 7026 of file pbx.c.

{
    unsigned int count;
    unsigned int insquares;
    unsigned int is_pattern;
 
    if (!dst_size--) {
        /* There really is no dst buffer */
        return 0;
    }
 
    count = 0;
    insquares = 0;
    is_pattern = *src == '_';
    while (*src && count < dst_size) {
        if (*src == '[') {
            if (is_pattern) {
                insquares = 1;
            }
        } else if (*src == ']') {
            insquares = 0;
        } else if (*src == ' ' && !insquares) {
            ++src;
            continue;
        } else if (*src == '-' && !insquares && nofluff) {
            ++src;
            continue;
        }
        *dst++ = *src++;
        ++count;
    }
    *dst = '\0';
 
    return count + 1;
}

Referenced by ast_add_extension2_lockopt(), and ast_context_remove_extension_callerid2().

extension_match_core()

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

static

Definition at line 2414 of file pbx.c.

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

References _extension_match_core(), ast_add_profile(), ast_mark(), ast_strlen_zero(), and ast_exten::data.

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

extension_presence_state_helper()

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

static

Definition at line 3200 of file pbx.c.

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

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(), ast_hint_presence_state(), and handle_hint_change_message_type().

extension_state_add_destroy()

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

{
    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] == '_') {
        ao2_lock(hints);
        ast_add_extension(e->parent->name, 0, exten, e->priority, e->label,
            e->matchcid ? e->cidmatch : NULL, e->app, ast_strdup(e->data), ast_free_ptr,
            e->registrar);
        ao2_unlock(hints);
        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;
}

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, voicemailpwcheck::context, ast_exten::data, ast_state_cb::data, ast_state_cb::destroy_cb, destroy_state_cb(), ast_exten::exten, ast_state_cb::extended, id, ast_state_cb::id, ast_exten::label, ast_exten::matchcid, ast_context::name, NULL, OBJ_NODATA, OBJ_UNLINK, ast_exten::parent, ast_exten::priority, ast_exten::registrar, statecbs, and stateid.

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

find_context()

static struct ast_context * find_context ( const char *  context )

static

lookup for a context with a given name,

Return values

found

context or NULL if not found.

Definition at line 4800 of file pbx.c.

{
    struct ast_context item = {
        .name = context,
    };
 
    return ast_hashtab_lookup(contexts_table, &item);
}

References ast_hashtab_lookup(), voicemailpwcheck::context, contexts_table, item, and aco_type::name.

Referenced by ast_add_extension_nolock(), and pbx_find_extension().

find_context_locked()

static struct ast_context * find_context_locked ( const char *  context )

static

lookup for a context with a given name,

Return values

with	conlock held if found.
NULL	if not found.

Definition at line 4814 of file pbx.c.

{
    struct ast_context *c;
    struct ast_context item = {
        .name = context,
    };
 
    ast_rdlock_contexts();
    c = ast_hashtab_lookup(contexts_table, &item);
    if (!c) {
        ast_unlock_contexts();
    }
 
    return c;
}

References ast_hashtab_lookup(), ast_rdlock_contexts(), ast_unlock_contexts(), c, voicemailpwcheck::context, contexts_table, item, and aco_type::name.

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

find_hint_by_cb_id()

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

static

Find Hint by callback id.

Definition at line 3842 of file pbx.c.

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

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

Referenced by ast_extension_state_del().

get_canmatch_exten()

static struct ast_exten * get_canmatch_exten ( struct match_char *  node )

static

Definition at line 1146 of file pbx.c.

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

References ast_log, ast_exten::exten, match_char::exten, LOG_NOTICE, and match_char::next_char.

get_device_state_causing_channels()

static void get_device_state_causing_channels ( struct ao2_container *  c )

static

Definition at line 3296 of file pbx.c.

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

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(), c, sip_to_pjsip::info(), and match().

Referenced by ast_extension_state_extended(), and device_state_notify_callbacks().

get_pattern_node()

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

static

Definition at line 1518 of file pbx.c.

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

References ast_log, compare_char(), first, INC_DST_OVERFLOW_CHECK, last, LOG_ERROR, and LOG_WARNING.

Referenced by add_exten_to_pattern_tree().

handle_debug_dialplan()

static char * handle_debug_dialplan ( struct ast_cli_entry *  e, int  cmd, struct ast_cli_args *  a  )

static

Send ack once.

Definition at line 5750 of file pbx.c.

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

References a, ast_cli(), AST_PBX_MAX_STACK, ast_strdupa, ast_strlen_zero(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_show_dialplan_context(), voicemailpwcheck::context, dialplan_counters::context_existence, NULL, show_debug_helper(), strsep(), dialplan_counters::total_context, and ast_cli_entry::usage.

handle_hint_change_message_type()

static int handle_hint_change_message_type ( struct stasis_message *  msg, enum ast_state_cb_update_reason  reason  )

static

Definition at line 3537 of file pbx.c.

{
    struct ast_hint *hint;
    struct ast_str *hint_app;
 
    if (hint_change_message_type() != stasis_message_type(msg)) {
        return 0;
    }
 
    if (!(hint_app = ast_str_create(1024))) {
        return -1;
    }
 
    hint = stasis_message_data(msg);
 
    switch (reason) {
    case AST_HINT_UPDATE_DEVICE:
        device_state_notify_callbacks(hint, &hint_app);
        break;
    case AST_HINT_UPDATE_PRESENCE:
        {
            char *presence_subtype = NULL;
            char *presence_message = NULL;
            int state;
 
            state = extension_presence_state_helper(
                hint->exten, &presence_subtype, &presence_message);
            {
                struct ast_presence_state_message presence_state = {
                    .state = state > 0 ? state : AST_PRESENCE_INVALID,
                    .subtype = presence_subtype,
                    .message = presence_message
                };
 
                presence_state_notify_callbacks(hint, &hint_app, &presence_state);
            }
 
            ast_free(presence_subtype);
            ast_free(presence_message);
        }
        break;
    }
 
    ast_free(hint_app);
    return 1;
}

References ast_free, AST_HINT_UPDATE_DEVICE, AST_HINT_UPDATE_PRESENCE, AST_PRESENCE_INVALID, ast_str_create, device_state_notify_callbacks(), ast_hint::exten, extension_presence_state_helper(), NULL, presence_state_notify_callbacks(), stasis_message_data(), stasis_message_type(), ast_presence_state_message::state, and state.

Referenced by device_state_cb().

handle_set_extenpatternmatchnew()

static char * handle_set_extenpatternmatchnew ( struct ast_cli_entry *  e, int  cmd, struct ast_cli_args *  a  )

static

Definition at line 6056 of file pbx.c.

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

References a, ast_cli(), CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, NULL, pbx_set_extenpatternmatchnew(), and ast_cli_entry::usage.

handle_show_dialplan()

static char * handle_show_dialplan ( struct ast_cli_entry *  e, int  cmd, struct ast_cli_args *  a  )

static

Definition at line 5683 of file pbx.c.

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

References a, ast_cli(), AST_PBX_MAX_STACK, ast_strdupa, ast_strlen_zero(), CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_show_dialplan_context(), voicemailpwcheck::context, dialplan_counters::context_existence, dialplan_counters::extension_existence, NULL, show_dialplan_helper(), strsep(), dialplan_counters::total_context, dialplan_counters::total_exten, dialplan_counters::total_prio, and ast_cli_entry::usage.

handle_show_hint()

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

{
    struct ast_hint *hint;
    int watchers;
    int num = 0, extenlen;
    struct ao2_iterator i;
    char buf[AST_MAX_EXTENSION+AST_MAX_CONTEXT+2];
 
    switch (cmd) {
    case CLI_INIT:
        e->command = "core show hint";
        e->usage =
            "Usage: core show hint <exten>\n"
            "       List registered hint.\n"
            "       Hint details are shown in five columns. In order from left to right, they are:\n"
            "       1. Hint extension URI.\n"
            "       2. List of mapped device or presence state identifiers.\n"
            "       3. Current extension state. The aggregate of mapped device states.\n"
            "       4. Current presence state for the mapped presence state provider.\n"
            "       5. Watchers - number of subscriptions and other entities watching this 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);
            sprintf(buf, "%s@%s",
                ast_get_extension_name(hint->exten),
                ast_get_context_name(ast_get_extension_context(hint->exten)));
            ast_cli(a->fd, "%-30.30s: %-60.60s  State:%-15.15s Presence:%-15.15s Watchers %2d\n",
                buf,
                ast_get_extension_app(hint->exten),
                ast_extension_state2str(hint->laststate),
                ast_presence_state2str(hint->last_presence_state),
                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;
}

References a, 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_MAX_CONTEXT, AST_MAX_EXTENSION, ast_presence_state2str(), buf, ast_hint::callbacks, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_core_show_hint(), ast_hint::exten, ast_hint::last_presence_state, ast_hint::laststate, NULL, and ast_cli_entry::usage.

handle_show_hints()

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

{
    struct ast_hint *hint;
    int num = 0;
    int watchers;
    struct ao2_iterator i;
    char buf[AST_MAX_EXTENSION+AST_MAX_CONTEXT+2];
 
    switch (cmd) {
    case CLI_INIT:
        e->command = "core show hints";
        e->usage =
            "Usage: core show hints\n"
            "       List registered hints.\n"
            "       Hint details are shown in five columns. In order from left to right, they are:\n"
            "       1. Hint extension URI.\n"
            "       2. List of mapped device or presence state identifiers.\n"
            "       3. Current extension state. The aggregate of mapped device states.\n"
            "       4. Current presence state for the mapped presence state provider.\n"
            "       5. Watchers - number of subscriptions and other entities watching this hint.\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);
        snprintf(buf, sizeof(buf), "%s@%s",
            ast_get_extension_name(hint->exten),
            ast_get_context_name(ast_get_extension_context(hint->exten)));
 
        ast_cli(a->fd, "%-30.30s: %-60.60s  State:%-15.15s Presence:%-15.15s Watchers %2d\n",
            buf,
            ast_get_extension_app(hint->exten),
            ast_extension_state2str(hint->laststate),
            ast_presence_state2str(hint->last_presence_state),
            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;
}

References a, 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_MAX_CONTEXT, AST_MAX_EXTENSION, ast_presence_state2str(), buf, ast_hint::callbacks, CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, ast_hint::exten, ast_hint::last_presence_state, ast_hint::laststate, NULL, and ast_cli_entry::usage.

handle_unset_extenpatternmatchnew()

static char * handle_unset_extenpatternmatchnew ( struct ast_cli_entry *  e, int  cmd, struct ast_cli_args *  a  )

static

Definition at line 6084 of file pbx.c.

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

References a, ast_cli(), CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, NULL, pbx_set_extenpatternmatchnew(), and ast_cli_entry::usage.

hashtab_compare_exten_labels()

static int hashtab_compare_exten_labels ( const void *  ah_a, const void *  ah_b  )

static

Definition at line 733 of file pbx.c.

{
    const struct ast_exten *ac = ah_a;
    const struct ast_exten *bc = ah_b;
    return strcmp(S_OR(ac->label, ""), S_OR(bc->label, ""));
}

References bc, ast_exten::label, and S_OR.

Referenced by ast_add_extension2_lockopt().

hashtab_compare_exten_numbers()

static int hashtab_compare_exten_numbers ( const void *  ah_a, const void *  ah_b  )

static

Definition at line 726 of file pbx.c.

{
    const struct ast_exten *ac = ah_a;
    const struct ast_exten *bc = ah_b;
    return ac->priority != bc->priority;
}

References bc, and ast_exten::priority.

Referenced by ast_add_extension2_lockopt().

hashtab_compare_extens()

static int hashtab_compare_extens ( const void *  ha_a, const void *  ah_b  )

static

Definition at line 698 of file pbx.c.

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

References AST_EXT_MATCHCID_ANY, AST_EXT_MATCHCID_OFF, ast_strlen_zero(), bc, ast_exten::cidmatch, ast_exten::exten, and ast_exten::matchcid.

Referenced by ast_add_extension2_lockopt().

hashtab_hash_extens()

static unsigned int hashtab_hash_extens ( const void *  obj )

static

Definition at line 746 of file pbx.c.

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

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

hashtab_hash_labels()

static unsigned int hashtab_hash_labels ( const void *  obj )

static

Definition at line 762 of file pbx.c.

{
    const struct ast_exten *ac = obj;
    return ast_hashtab_hash_string(S_OR(ac->label, ""));
}

References ast_hashtab_hash_string(), ast_exten::label, and S_OR.

Referenced by ast_add_extension2_lockopt().

hashtab_hash_priority()

static unsigned int hashtab_hash_priority ( const void *  obj )

static

Definition at line 756 of file pbx.c.

{
    const struct ast_exten *ac = obj;
    return ast_hashtab_hash_int(ac->priority);
}

References ast_hashtab_hash_int(), and ast_exten::priority.

Referenced by ast_add_extension2_lockopt().

hint_cmp()

static int hint_cmp ( void *  obj, void *  arg, int  flags  )

static

Definition at line 8896 of file pbx.c.

{
    const struct ast_hint *hint = obj;
    const struct ast_exten *exten = arg;
 
    return (hint->exten == exten) ? CMP_MATCH | CMP_STOP : 0;
}

References CMP_MATCH, CMP_STOP, ast_exten::exten, and ast_hint::exten.

Referenced by ast_pbx_init().

hint_hash()

static int hint_hash ( const void *  obj, const int  flags  )

static

Definition at line 8876 of file pbx.c.

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

References ast_get_extension_name(), ast_str_case_hash(), ast_strlen_zero(), ast_hint::exten, and exten_name.

Referenced by ast_pbx_init().

hint_id_cmp()

static int hint_id_cmp ( void *  obj, void *  arg, int  flags  )

static

Definition at line 3889 of file pbx.c.

{
    const struct ast_state_cb *cb = obj;
    int *id = arg;
 
    return (cb->id == *id) ? CMP_MATCH | CMP_STOP : 0;
}

References CMP_MATCH, CMP_STOP, and ast_state_cb::id.

Referenced by ast_add_hint().

hintdevice_cmp_multiple()

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

{
    struct ast_hintdevice *left = obj;
    struct ast_hintdevice *right = arg;
    const char *right_key = arg;
    int cmp;
 
    switch (flags & OBJ_SEARCH_MASK) {
    case OBJ_SEARCH_OBJECT:
        right_key = right->hintdevice;
        /* Fall through */
    case OBJ_SEARCH_KEY:
        cmp = strcasecmp(left->hintdevice, right_key);
        break;
    case OBJ_SEARCH_PARTIAL_KEY:
        /*
        * We could also use a partial key struct containing a length
        * so strlen() does not get called for every comparison instead.
        */
        cmp = strncmp(left->hintdevice, right_key, strlen(right_key));
        break;
    default:
        ast_assert(0);
        cmp = 0;
        break;
    }
    return cmp ? 0 : CMP_MATCH;
}

References ast_assert, CMP_MATCH, ast_hintdevice::hintdevice, OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, OBJ_SEARCH_OBJECT, and OBJ_SEARCH_PARTIAL_KEY.

Referenced by ast_pbx_init(), device_state_cb(), and presence_state_cb().

hintdevice_destroy()

static void hintdevice_destroy ( void *  obj )

static

Definition at line 545 of file pbx.c.

{
    struct ast_hintdevice *doomed = obj;
 
    if (doomed->hint) {
        ao2_ref(doomed->hint, -1);
        doomed->hint = NULL;
    }
}

References ao2_ref, ast_hintdevice::hint, and NULL.

Referenced by add_hintdevice().

hintdevice_hash_cb()

static int hintdevice_hash_cb ( const void *  obj, const int  flags  )

static

Note

Using the device for hash

Definition at line 402 of file pbx.c.

{
    const struct ast_hintdevice *ext;
    const char *key;
 
    switch (flags & OBJ_SEARCH_MASK) {
    case OBJ_SEARCH_KEY:
        key = obj;
        break;
    case OBJ_SEARCH_OBJECT:
        ext = obj;
        key = ext->hintdevice;
        break;
    default:
        ast_assert(0);
        return 0;
    }
 
    return ast_str_case_hash(key);
}

References ast_assert, ast_str_case_hash(), ext, OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, and OBJ_SEARCH_OBJECT.

Referenced by ast_pbx_init().

hintdevice_remove_cb()

static int hintdevice_remove_cb ( void *  obj, void *  arg, void *  data, int  flags  )

static

Definition at line 511 of file pbx.c.

{
    struct ast_hintdevice *candidate = obj;
    char *device = arg;
    struct ast_hint *hint = data;
 
    if (!strcasecmp(candidate->hintdevice, device)
        && candidate->hint == hint) {
        return CMP_MATCH;
    }
    return 0;
}

References CMP_MATCH, ast_hintdevice::hint, and ast_hintdevice::hintdevice.

Referenced by remove_hintdevice().

increase_call_count()

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

{
    int failed = 0;
    double curloadavg;
#if defined(HAVE_SYSINFO)
    struct sysinfo sys_info;
#endif
 
    ast_mutex_lock(&maxcalllock);
    if (ast_option_maxcalls) {
        if (countcalls >= ast_option_maxcalls) {
            ast_log(LOG_WARNING, "Maximum call limit of %d calls exceeded by '%s'!\n", ast_option_maxcalls, ast_channel_name(c));
            failed = -1;
        }
    }
    if (ast_option_maxload) {
        getloadavg(&curloadavg, 1);
        if (curloadavg >= ast_option_maxload) {
            ast_log(LOG_WARNING, "Maximum loadavg limit of %f load exceeded by '%s' (currently %f)!\n", ast_option_maxload, ast_channel_name(c), curloadavg);
            failed = -1;
        }
    }
#if defined(HAVE_SYSINFO)
    if (option_minmemfree) {
        /* Make sure that the free system memory is above the configured low watermark */
        if (!sysinfo(&sys_info)) {
            /* Convert the amount of available RAM from mem_units to MB. The calculation
             * was done this way to avoid overflow problems */
            uint64_t curfreemem = sys_info.freeram + sys_info.bufferram;
            curfreemem *= sys_info.mem_unit;
            curfreemem /= 1024 * 1024;
            if (curfreemem < option_minmemfree) {
                ast_log(LOG_WARNING, "Available system memory (~%" PRIu64 "MB) is below the configured low watermark (%ldMB)\n",
                    curfreemem, option_minmemfree);
                failed = -1;
            }
        }
    }
#endif
 
    if (!failed) {
        countcalls++;
        totalcalls++;
    }
    ast_mutex_unlock(&maxcalllock);
 
    return failed;
}

References ast_channel_name(), ast_log, ast_mutex_lock, ast_mutex_unlock, ast_option_maxcalls, ast_option_maxload, c, countcalls, getloadavg(), LOG_WARNING, maxcalllock, option_minmemfree, and totalcalls.

Referenced by ast_pbx_run_args(), and ast_pbx_start().

insert_in_next_chars_alt_char_list()

static void insert_in_next_chars_alt_char_list ( struct match_char **  parent_ptr, struct match_char *  node  )

static

Definition at line 1423 of file pbx.c.

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

References match_char::alt_char, and match_char::specificity.

Referenced by add_pattern_node().

internal_extension_state_extended()

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

{
    struct ast_exten *e;
 
    if (!(e = ast_hint_extension(c, context, exten))) {  /* Do we have a hint for this extension ? */
        return -1;                   /* No hint, return -1 */
    }
 
    if (e->exten[0] == '_') {
        /* Create this hint on-the-fly, we explicitly lock hints here to ensure the
         * same locking order as if this were done through configuration file - that is
         * hints is locked first and then (if needed) contexts is locked
         */
        ao2_lock(hints);
        ast_add_extension(e->parent->name, 0, exten, e->priority, e->label,
            e->matchcid ? e->cidmatch : NULL, e->app, ast_strdup(e->data), ast_free_ptr,
            e->registrar);
        ao2_unlock(hints);
        if (!(e = ast_hint_extension(c, context, exten))) {
            /* Improbable, but not impossible */
            return -1;
        }
    }
 
    return ast_extension_state2(e, device_state_info);  /* Check all devices in the hint */
}

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

Referenced by ast_extension_state(), and ast_extension_state_extended().

load_pbx()

int load_pbx

(

void

)

Provided by pbx.c

Definition at line 8421 of file pbx.c.

{
    int res = 0;
 
    ast_register_cleanup(unload_pbx);
 
    /* Initialize the PBX */
    ast_verb(1, "Asterisk PBX Core Initializing\n");
 
    ast_verb(5, "Registering builtin functions:\n");
    ast_cli_register_multiple(pbx_cli, ARRAY_LEN(pbx_cli));
    __ast_custom_function_register(&exception_function, NULL);
    __ast_custom_function_register(&testtime_function, NULL);
 
    /* Register manager application */
    res |= ast_manager_register_xml_core("ShowDialPlan", EVENT_FLAG_CONFIG | EVENT_FLAG_REPORTING, manager_show_dialplan);
    res |= ast_manager_register_xml_core("ExtensionStateList", EVENT_FLAG_CALL | EVENT_FLAG_REPORTING, action_extensionstatelist);
 
    if (res) {
        return -1;
    }
 
    if (!(device_state_sub = stasis_subscribe(ast_device_state_topic_all(), device_state_cb, NULL))) {
        return -1;
    }
    stasis_subscription_accept_message_type(device_state_sub, ast_device_state_message_type());
    stasis_subscription_accept_message_type(device_state_sub, hint_change_message_type());
    stasis_subscription_accept_message_type(device_state_sub, hint_remove_message_type());
    stasis_subscription_set_filter(device_state_sub, STASIS_SUBSCRIPTION_FILTER_SELECTIVE);
 
    if (!(presence_state_sub = stasis_subscribe(ast_presence_state_topic_all(), presence_state_cb, NULL))) {
        return -1;
    }
    stasis_subscription_accept_message_type(presence_state_sub, ast_presence_state_message_type());
    stasis_subscription_set_filter(presence_state_sub, STASIS_SUBSCRIPTION_FILTER_SELECTIVE);
 
    return 0;
}

References __ast_custom_function_register(), action_extensionstatelist(), ARRAY_LEN, ast_cli_register_multiple, ast_device_state_message_type(), ast_device_state_topic_all(), ast_manager_register_xml_core, ast_presence_state_message_type(), ast_presence_state_topic_all(), ast_register_cleanup(), ast_verb, device_state_cb(), device_state_sub, EVENT_FLAG_CALL, EVENT_FLAG_CONFIG, EVENT_FLAG_REPORTING, exception_function, manager_show_dialplan(), NULL, pbx_cli, presence_state_cb(), presence_state_sub, stasis_subscribe, stasis_subscription_accept_message_type(), STASIS_SUBSCRIPTION_FILTER_SELECTIVE, stasis_subscription_set_filter(), testtime_function, and unload_pbx().

Referenced by asterisk_daemon().

manager_dpsendack()

static void manager_dpsendack ( struct mansession *  s, const struct message *  m  )

static

Send ack once.

Definition at line 5806 of file pbx.c.

{
    astman_send_listack(s, m, "DialPlan list will follow", "start");
}

References astman_send_listack().

Referenced by manager_show_dialplan(), and manager_show_dialplan_helper().

manager_show_dialplan()

static int manager_show_dialplan ( struct mansession *  s, const struct message *  m  )

static

Manager listing of dial plan.

Definition at line 5970 of file pbx.c.

{
    const char *exten, *context;
    const char *id = astman_get_header(m, "ActionID");
    const char *incstack[AST_PBX_MAX_STACK];
    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, 0, incstack);
 
    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_send_list_complete_start(s, m, "ShowDialPlanComplete", counters.total_items);
    astman_append(s,
        "ListExtensions: %d\r\n"
        "ListPriorities: %d\r\n"
        "ListContexts: %d\r\n",
        counters.total_exten, counters.total_prio, counters.total_context);
    astman_send_list_complete_end(s);
 
    /* everything ok */
    return 0;
}

References AST_PBX_MAX_STACK, ast_strlen_zero(), astman_append(), astman_get_header(), astman_send_error(), astman_send_list_complete_end(), astman_send_list_complete_start(), voicemailpwcheck::context, dialplan_counters::context_existence, dialplan_counters::extension_existence, manager_dpsendack(), manager_show_dialplan_helper(), NULL, dialplan_counters::total_context, dialplan_counters::total_exten, dialplan_counters::total_items, and dialplan_counters::total_prio.

Referenced by load_pbx().

manager_show_dialplan_helper()

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, const struct ast_include *  rinclude, int  includecount, const char *  includes[]  )

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

{
    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)) ) {
        int idx;
        struct ast_exten *e;
 
        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));
            }
        }
 
        for (idx = 0; idx < ast_context_includes_count(c); idx++) {
            const struct ast_include *i = ast_context_includes_get(c, idx);
 
            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);
                        manager_show_dialplan_helper(s, m, actionidtext, 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 {
                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));
            }
        }
 
        for (idx = 0; idx < ast_context_ignorepats_count(c); idx++) {
            const struct ast_ignorepat *ip = ast_context_ignorepats_get(c, idx);
            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) {
            for (idx = 0; idx < ast_context_switches_count(c); idx++) {
                const struct ast_sw *sw = ast_context_switches_get(c, idx);
 
                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;
    }
}

References ast_context_ignorepats_count(), ast_context_ignorepats_get(), ast_context_includes_count(), ast_context_includes_get(), ast_context_switches_count(), ast_context_switches_get(), 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_PBX_MAX_STACK, ast_rdlock_context(), ast_rdlock_contexts(), ast_strlen_zero(), ast_unlock_context(), ast_unlock_contexts(), ast_walk_context_extensions(), ast_walk_contexts(), ast_walk_extension_priorities(), astman_append(), astman_send_error(), c, voicemailpwcheck::context, dialplan_counters::context_existence, ast_exten::exten, dialplan_counters::extension_existence, LOG_WARNING, manager_dpsendack(), manager_show_dialplan_helper(), NULL, PRIORITY_HINT, dialplan_counters::total_context, dialplan_counters::total_exten, dialplan_counters::total_items, and dialplan_counters::total_prio.

Referenced by manager_show_dialplan(), and manager_show_dialplan_helper().

matchcid()

static int matchcid ( const char *  cidpattern, const char *  callerid  )

static

Definition at line 2470 of file pbx.c.

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

References ast_extension_match(), and ast_strlen_zero().

Referenced by pbx_find_extension().

new_find_extension()

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

{
    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 && !MORE(str)) { /* 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->name);                       \
                                    return; /* the first match, by definition, will be the best, because of the sorted tree */           \
                                }                                                                                                        \
                            }                                                                                                            \
                        }                                                                                                                \
                    }
 
#define NEW_MATCHER_RECURSE            \
                    if (p->next_char && (MORE(str) || (p->next_char->x[0] == '/' && p->next_char->x[1] == 0)                 \
                                               || p->next_char->x[0] == '!')) {                                          \
                        if (MORE(str) || p->next_char->x[0] == '!') {                                                         \
                            new_find_extension(ADVANCE(str), 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->name);                         \
                                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->name :      \
                                       "NULL");                                                                        \
                                return; /* the first match is all we need */                                                 \
                            }                                                                                                \
                        }                                                                                                    \
                    } else if ((p->next_char || action == E_CANMATCH) && !MORE(str)) {                                                                  \
                        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->name);
                        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->name : "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->name);
                        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->name : "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->name : "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");
}

References match_char::alt_char, ast_debug, ast_log, scoreboard::canmatch, match_char::deleted, E_CANMATCH, E_MATCHMORE, match_char::exten, scoreboard::exten, match_char::is_pattern, ast_exten::label, LOG_NOTICE, ast_exten::name, new_find_extension(), NEW_MATCHER_CHK_MATCH, NEW_MATCHER_RECURSE, match_char::next_char, match_char::specificity, str, update_scoreboard(), and match_char::x.

Referenced by new_find_extension(), and pbx_find_extension().

parse_hint_device()

static char * parse_hint_device ( struct ast_str *  hint_args )

static

Definition at line 3056 of file pbx.c.

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

References ast_str_buffer(), ast_str_set(), ast_strdupa, copy(), and tmp().

Referenced by ast_extension_state3().

parse_hint_presence()

static char * parse_hint_presence ( struct ast_str *  hint_args )

static

Definition at line 3037 of file pbx.c.

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

References ast_str_buffer(), ast_str_set(), ast_strdupa, copy(), NULL, and tmp().

Referenced by extension_presence_state_helper().

pbx_checkcondition()

int pbx_checkcondition

(

const char *

condition

)

Evaluate a condition.

Return values

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

Definition at line 8282 of file pbx.c.

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

References ast_strlen_zero().

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

pbx_destroy()

static void pbx_destroy ( struct ast_pbx *  p )

static

Definition at line 990 of file pbx.c.

{
    ast_free(p);
}

References ast_free.

Referenced by __ast_pbx_run().

pbx_dial_reason()

static enum ast_control_frame_type pbx_dial_reason ( enum ast_dial_result  dial_result, int  cause  )

static

Attempt to convert disconnect cause to old originate reason.

Todo:

XXX The old originate reasons need to be trashed and replaced with normal disconnect cause codes if the call was not answered. The internal consumers of the reason values would also need to be updated: app_originate, call files, and AMI OriginateResponse.

Definition at line 7681 of file pbx.c.

{
    enum ast_control_frame_type pbx_reason;
 
    if (dial_result == AST_DIAL_RESULT_ANSWERED) {
        /* Remote end answered. */
        pbx_reason = AST_CONTROL_ANSWER;
    } else if (dial_result == AST_DIAL_RESULT_HANGUP) {
        /* Caller hungup */
        pbx_reason = AST_CONTROL_HANGUP;
    } else {
        switch (cause) {
        case AST_CAUSE_USER_BUSY:
            pbx_reason = AST_CONTROL_BUSY;
            break;
        case AST_CAUSE_CALL_REJECTED:
        case AST_CAUSE_NETWORK_OUT_OF_ORDER:
        case AST_CAUSE_DESTINATION_OUT_OF_ORDER:
        case AST_CAUSE_NORMAL_TEMPORARY_FAILURE:
        case AST_CAUSE_SWITCH_CONGESTION:
        case AST_CAUSE_NORMAL_CIRCUIT_CONGESTION:
            pbx_reason = AST_CONTROL_CONGESTION;
            break;
        case AST_CAUSE_ANSWERED_ELSEWHERE:
        case AST_CAUSE_NO_ANSWER:
            /* Remote end was ringing (but isn't anymore) */
            pbx_reason = AST_CONTROL_RINGING;
            break;
        case AST_CAUSE_UNALLOCATED:
        default:
            /* Call Failure (not BUSY, and not NO_ANSWER, maybe Circuit busy or down?) */
            pbx_reason = 0;
            break;
        }
    }
 
    return pbx_reason;
}

References AST_CAUSE_ANSWERED_ELSEWHERE, AST_CAUSE_CALL_REJECTED, AST_CAUSE_DESTINATION_OUT_OF_ORDER, AST_CAUSE_NETWORK_OUT_OF_ORDER, AST_CAUSE_NO_ANSWER, AST_CAUSE_NORMAL_CIRCUIT_CONGESTION, AST_CAUSE_NORMAL_TEMPORARY_FAILURE, AST_CAUSE_SWITCH_CONGESTION, AST_CAUSE_UNALLOCATED, AST_CAUSE_USER_BUSY, AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_HANGUP, AST_CONTROL_RINGING, AST_DIAL_RESULT_ANSWERED, and AST_DIAL_RESULT_HANGUP.

Referenced by pbx_outgoing_attempt().

pbx_extension_helper()

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

{
    struct ast_exten *e;
    struct ast_app *app;
    char *substitute = NULL;
    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 (!context) {
        context = con->name;
    }
 
    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 */
            int res = e->priority;
 
            ast_unlock_contexts();
 
            /* the priority we were looking for */
            return res;
        } 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);
            }
            ast_debug(1, "Launching '%s'\n", app_name(app));
            if (VERBOSITY_ATLEAST(3)) {
                ast_verb(3, "Executing [%s@%s:%d] " COLORIZE_FMT "(\"" COLORIZE_FMT "\", \"" COLORIZE_FMT "\") %s\n",
                    exten, context, priority,
                    COLORIZE(COLOR_BRCYAN, 0, app_name(app)),
                    COLORIZE(COLOR_BRMAGENTA, 0, ast_channel_name(c)),
                    COLORIZE(COLOR_BRMAGENTA, 0, passdata),
                    "in new stack");
            }
            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);
                return -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", S_OR(label, ""), exten, S_OR(context, ""));
            break;
        default:
            ast_debug(1, "Shouldn't happen!\n");
        }
 
        return (matching_action) ? 0 : -1;
    }
}

References app, ast_exten::app, app_name(), ast_channel_context(), ast_channel_context_set(), ast_channel_exten(), ast_channel_exten_set(), ast_channel_name(), ast_channel_priority_set(), ast_copy_string(), ast_debug, ast_log, ast_rdlock_contexts(), ast_strdupa, ast_strlen_zero(), ast_unlock_contexts(), ast_verb, c, ast_exten::cached_app, COLOR_BRCYAN, COLOR_BRMAGENTA, COLORIZE, COLORIZE_FMT, voicemailpwcheck::context, pbx_find_info::data, ast_exten::data, E_CANMATCH, E_FINDLABEL, E_MATCH, E_MATCHMORE, ast_switch::exec, EXT_DATA_SIZE, pbx_find_info::foundcontext, LOG_NOTICE, LOG_WARNING, ast_switch::name, ast_context::name, NULL, pbx_exec(), pbx_find_extension(), pbx_findapp(), pbx_substitute_variables_helper(), priority, 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, tmp(), and VERBOSITY_ATLEAST.

Referenced by ast_canmatch_extension(), ast_exists_extension(), ast_findlabel_extension(), ast_findlabel_extension2(), ast_matchmore_extension(), and ast_spawn_extension().

pbx_find_extension()

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

Definition at line 2482 of file pbx.c.

{
    int x, res;
    struct ast_context *tmp = NULL;
    struct ast_exten *e = NULL, *eroot = NULL;
    struct ast_exten pattern = {NULL, };
    struct scoreboard score = {0, };
    struct ast_str *tmpdata = NULL;
    int idx;
 
    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 (%d) exceeded. Too many includes?\n", AST_PBX_MAX_STACK);
        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 */
    for (idx = 0; idx < ast_context_switches_count(tmp); idx++) {
        const struct ast_sw *sw = ast_context_switches_get(tmp, idx);
        struct ast_switch *asw = pbx_findswitch(ast_get_switch_name(sw));
        ast_switch_f *aswf = NULL;
        const char *datap;
 
        if (!asw) {
            ast_log(LOG_WARNING, "No such switch '%s'\n", ast_get_switch_name(sw));
            continue;
        }
 
        /* Substitute variables now */
        if (ast_get_switch_eval(sw)) {
            if (!(tmpdata = ast_str_thread_get(&switch_data, 512))) {
                ast_log(LOG_WARNING, "Can't evaluate switch?!\n");
                continue;
            }
            pbx_substitute_variables_helper(chan, ast_get_switch_data(sw),
                ast_str_buffer(tmpdata), ast_str_size(tmpdata));
            datap = ast_str_buffer(tmpdata);
        } else {
            datap = ast_get_switch_data(sw);
        }
 
        /* 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;
        }
    }
    /* Technically we should be using tmp->name here, but if we used that we
     * would have to cast away the constness of the 'name' pointer and I do
     * not want to do that. */
    q->incstack[q->stacklen++] = tmp->data; /* Setup the stack */
    /* Now try any includes we have in this context */
    for (idx = 0; idx < ast_context_includes_count(tmp); idx++) {
        const struct ast_include *i = ast_context_includes_get(tmp, idx);
 
        if (include_valid(i)) {
            if ((e = pbx_find_extension(chan, bypass, q, include_rname(i), 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;
}

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

Referenced by ast_get_extension_data(), ast_hint_extension_nolock(), ast_merge_contexts_and_delete(), pbx_extension_helper(), and pbx_find_extension().

pbx_outgoing_attempt()

static int pbx_outgoing_attempt ( const char *  type, struct ast_format_cap *  cap, const char *  addr, int  timeout, const char *  context, const char *  exten, int  priority, 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, int  early_media, const struct ast_assigned_ids *  assignedids, const char *  predial_callee  )

static

Definition at line 7720 of file pbx.c.

{
    RAII_VAR(struct pbx_outgoing *, outgoing, NULL, ao2_cleanup);
    struct ast_channel *dialed;
    pthread_t thread;
    char tmp_cid_name[128];
    char tmp_cid_num[128];
 
    outgoing = ao2_alloc(sizeof(*outgoing), pbx_outgoing_destroy);
    if (!outgoing) {
        return -1;
    }
    ast_cond_init(&outgoing->cond, NULL);
 
    if (!ast_strlen_zero(app)) {
        ast_copy_string(outgoing->app, app, sizeof(outgoing->app));
        outgoing->appdata = ast_strdup(appdata);
    } else {
        ast_copy_string(outgoing->context, context, sizeof(outgoing->context));
        ast_copy_string(outgoing->exten, exten, sizeof(outgoing->exten));
        outgoing->priority = priority;
    }
 
    if (!(outgoing->dial = ast_dial_create())) {
        return -1;
    }
 
    if (ast_dial_append(outgoing->dial, type, addr, assignedids)) {
        return -1;
    }
 
    ast_dial_set_global_timeout(outgoing->dial, timeout);
 
    if (!ast_strlen_zero(predial_callee)) {
        /* note casting to void * here to suppress compiler warning message (passing const to non-const function) */
        ast_dial_option_global_enable(outgoing->dial, AST_DIAL_OPTION_PREDIAL, (void *)predial_callee);
    }
 
    if (ast_dial_prerun(outgoing->dial, NULL, cap)) {
        if (synchronous && reason) {
            *reason = pbx_dial_reason(AST_DIAL_RESULT_FAILED,
                ast_dial_reason(outgoing->dial, 0));
        }
        return -1;
    }
 
    dialed = ast_dial_get_channel(outgoing->dial, 0);
    if (!dialed) {
        return -1;
    }
 
    ast_channel_lock(dialed);
    if (vars) {
        ast_set_variables(dialed, vars);
    }
    if (!ast_strlen_zero(account)) {
        ast_channel_stage_snapshot(dialed);
        ast_channel_accountcode_set(dialed, account);
        ast_channel_peeraccount_set(dialed, account);
        ast_channel_stage_snapshot_done(dialed);
    }
    ast_set_flag(ast_channel_flags(dialed), AST_FLAG_ORIGINATED);
 
    if (!ast_strlen_zero(predial_callee)) {
        char *tmp = NULL;
        /*
         * The predial sub routine may have set callerid so set this into the new channel
         * Note... cid_num and cid_name parameters to this function will always be NULL if
         * predial_callee is non-NULL so we are not overwriting anything here.
         */
        tmp = S_COR(ast_channel_caller(dialed)->id.number.valid, ast_channel_caller(dialed)->id.number.str, NULL);
        if (tmp) {
            ast_copy_string(tmp_cid_num, tmp, sizeof(tmp_cid_num));
            cid_num = tmp_cid_num;
        }
        tmp = S_COR(ast_channel_caller(dialed)->id.name.valid, ast_channel_caller(dialed)->id.name.str, NULL);
        if (tmp) {
            ast_copy_string(tmp_cid_name, tmp, sizeof(tmp_cid_name));
            cid_name = tmp_cid_name;
        }
    }
    ast_channel_unlock(dialed);
 
    if (!ast_strlen_zero(cid_num) || !ast_strlen_zero(cid_name)) {
        struct ast_party_connected_line connected;
 
        /*
         * It seems strange to set the CallerID on an outgoing call leg
         * to whom we are calling, but this function's callers are doing
         * various Originate methods.  This call leg goes to the local
         * user.  Once the called party answers, the dialplan needs to
         * be able to access the CallerID from the CALLERID function as
         * if the called party had placed this call.
         */
        ast_set_callerid(dialed, cid_num, cid_name, cid_num);
 
        ast_party_connected_line_set_init(&connected, ast_channel_connected(dialed));
        if (!ast_strlen_zero(cid_num)) {
            connected.id.number.valid = 1;
            connected.id.number.str = (char *) cid_num;
            connected.id.number.presentation = AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED;
        }
        if (!ast_strlen_zero(cid_name)) {
            connected.id.name.valid = 1;
            connected.id.name.str = (char *) cid_name;
            connected.id.name.presentation = AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED;
        }
        ast_channel_set_connected_line(dialed, &connected, NULL);
    }
 
    if (early_media) {
        ast_dial_set_state_callback(outgoing->dial, pbx_outgoing_state_callback);
    }
 
    if (locked_channel) {
        /*
         * Keep a dialed channel ref since the caller wants
         * the channel returned.  We must get the ref before
         * spawning off pbx_outgoing_exec().
         */
        ast_channel_ref(dialed);
        if (!synchronous) {
            /*
             * Lock it now to hold off pbx_outgoing_exec() in case the
             * calling function needs the channel state/snapshot before
             * dialing actually happens.
             */
            ast_channel_lock(dialed);
        }
    }
 
    /* This extra reference is dereferenced by pbx_outgoing_exec */
    ao2_ref(outgoing, +1);
 
    if (synchronous == AST_OUTGOING_WAIT_COMPLETE) {
        /*
         * Because we are waiting until this is complete anyway, there is no
         * sense in creating another thread that we will just need to wait
         * for, so instead we commandeer the current thread.
         */
        pbx_outgoing_exec(outgoing);
    } else {
        outgoing->in_separate_thread = 1;
 
        if (ast_pthread_create_detached(&thread, NULL, pbx_outgoing_exec, outgoing)) {
            ast_log(LOG_WARNING, "Unable to spawn dialing thread for '%s/%s'\n", type, addr);
            ao2_ref(outgoing, -1);
            if (locked_channel) {
                if (!synchronous) {
                    ast_channel_unlock(dialed);
                }
                ast_channel_unref(dialed);
            }
            return -1;
        }
 
        if (synchronous) {
            ao2_lock(outgoing);
            /* Wait for dialing to complete */
            while (!outgoing->dialed) {
                ast_cond_wait(&outgoing->cond, ao2_object_get_lockaddr(outgoing));
            }
            ao2_unlock(outgoing);
        }
    }
 
    if (synchronous) {
        /* Determine the outcome of the dialing attempt up to it being answered. */
        if (reason) {
            *reason = pbx_dial_reason(outgoing->dial_res,
                ast_dial_reason(outgoing->dial, 0));
        }
 
        if (outgoing->dial_res != AST_DIAL_RESULT_ANSWERED) {
            /* The dial operation failed. */
            if (locked_channel) {
                ast_channel_unref(dialed);
            }
            return -1;
        }
        if (locked_channel) {
            ast_channel_lock(dialed);
        }
    }
 
    if (locked_channel) {
        *locked_channel = dialed;
    }
    return 0;
}

References ao2_alloc, ao2_cleanup, ao2_lock, ao2_object_get_lockaddr(), ao2_ref, ao2_unlock, app, outgoing::app, ast_channel_caller(), ast_channel_connected(), ast_channel_flags(), ast_channel_lock, ast_channel_ref, ast_channel_set_connected_line(), ast_channel_stage_snapshot(), ast_channel_stage_snapshot_done(), ast_channel_unlock, ast_channel_unref, ast_cond_init, ast_cond_wait, ast_copy_string(), ast_dial_append(), ast_dial_create(), ast_dial_get_channel(), ast_dial_option_global_enable(), AST_DIAL_OPTION_PREDIAL, ast_dial_prerun(), ast_dial_reason(), AST_DIAL_RESULT_ANSWERED, AST_DIAL_RESULT_FAILED, ast_dial_set_global_timeout(), ast_dial_set_state_callback(), AST_FLAG_ORIGINATED, ast_log, AST_OUTGOING_WAIT_COMPLETE, ast_party_connected_line_set_init(), AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED, ast_pthread_create_detached, ast_set_callerid(), ast_set_flag, ast_set_variables(), ast_strdup, ast_strlen_zero(), connected, voicemailpwcheck::context, outgoing::context, ast_channel::dialed, ast_channel::exten, outgoing::exten, LOG_WARNING, name, NULL, pbx_dial_reason(), pbx_outgoing_destroy(), pbx_outgoing_exec(), pbx_outgoing_state_callback(), priority, outgoing::priority, RAII_VAR, S_COR, thread, tmp(), and type.

Referenced by ast_pbx_outgoing_app_predial(), and ast_pbx_outgoing_exten_predial().

pbx_outgoing_destroy()

static void pbx_outgoing_destroy ( void *  obj )

static

Destructor for outgoing structure.

Definition at line 7578 of file pbx.c.

{
    struct pbx_outgoing *outgoing = obj;
 
    if (outgoing->dial) {
        ast_dial_destroy(outgoing->dial);
    }
 
    ast_cond_destroy(&outgoing->cond);
 
    ast_free(outgoing->appdata);
}

References ast_cond_destroy, ast_dial_destroy(), and ast_free.

Referenced by pbx_outgoing_attempt().

pbx_outgoing_exec()

static void * pbx_outgoing_exec ( void *  data )

static

Internal function which dials an outgoing leg and sends it to a provided extension or application.

Definition at line 7592 of file pbx.c.

{
    RAII_VAR(struct pbx_outgoing *, outgoing, data, ao2_cleanup);
    enum ast_dial_result res;
    struct ast_channel *chan;
 
    res = ast_dial_run(outgoing->dial, NULL, 0);
 
    if (outgoing->in_separate_thread) {
        /* Notify anyone interested that dialing is complete */
        ao2_lock(outgoing);
        outgoing->dial_res = res;
        outgoing->dialed = 1;
        ast_cond_signal(&outgoing->cond);
        ao2_unlock(outgoing);
    } else {
        /* We still need the dial result, but we don't need to lock */
        outgoing->dial_res = res;
    }
 
    /* If the outgoing leg was not answered we can immediately return and go no further */
    if (res != AST_DIAL_RESULT_ANSWERED) {
        return NULL;
    }
 
    /* We steal the channel so we get ownership of when it is hung up */
    chan = ast_dial_answered_steal(outgoing->dial);
 
    if (!ast_strlen_zero(outgoing->app)) {
        struct ast_app *app = pbx_findapp(outgoing->app);
 
        if (app) {
            ast_verb(4, "Launching %s(%s) on %s\n", outgoing->app, S_OR(outgoing->appdata, ""),
                ast_channel_name(chan));
            pbx_exec(chan, app, outgoing->appdata);
        } else {
            ast_log(LOG_WARNING, "No such application '%s'\n", outgoing->app);
        }
 
        ast_hangup(chan);
    } else {
        if (!ast_strlen_zero(outgoing->context)) {
            ast_channel_context_set(chan, outgoing->context);
        }
 
        if (!ast_strlen_zero(outgoing->exten)) {
            ast_channel_exten_set(chan, outgoing->exten);
        }
 
        if (outgoing->priority > 0) {
            ast_channel_priority_set(chan, outgoing->priority);
        }
 
        if (ast_pbx_run(chan)) {
            ast_log(LOG_ERROR, "Failed to start PBX on %s\n", ast_channel_name(chan));
            ast_hangup(chan);
        }
    }
 
    return NULL;
}

References ao2_cleanup, ao2_lock, ao2_unlock, app, outgoing::app, ast_channel_context_set(), ast_channel_exten_set(), ast_channel_name(), ast_channel_priority_set(), ast_cond_signal, ast_dial_answered_steal(), AST_DIAL_RESULT_ANSWERED, ast_dial_run(), ast_hangup(), ast_log, ast_pbx_run(), ast_strlen_zero(), ast_verb, outgoing::context, outgoing::exten, LOG_ERROR, LOG_WARNING, NULL, pbx_exec(), pbx_findapp(), outgoing::priority, RAII_VAR, and S_OR.

Referenced by pbx_outgoing_attempt().

pbx_outgoing_state_callback()

static void pbx_outgoing_state_callback ( struct ast_dial *  dial )

static

Internal dialing state callback which causes early media to trigger an answer.

Definition at line 7655 of file pbx.c.

{
    struct ast_channel *channel;
 
    if (ast_dial_state(dial) != AST_DIAL_RESULT_PROGRESS) {
        return;
    }
 
    if (!(channel = ast_dial_get_channel(dial, 0))) {
        return;
    }
 
    ast_verb(4, "Treating progress as answer on '%s' due to early media option\n",
        ast_channel_name(channel));
 
    ast_queue_control(channel, AST_CONTROL_ANSWER);
}

References ast_channel_name(), AST_CONTROL_ANSWER, ast_dial_get_channel(), AST_DIAL_RESULT_PROGRESS, ast_dial_state(), ast_queue_control(), and ast_verb.

Referenced by pbx_outgoing_attempt().

pbx_parse_location()

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

Parses a dialplan location into context, extension, priority.

Parameters

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

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

Return values

0	success
non-zero	failure

Definition at line 8791 of file pbx.c.

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

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

Referenced by eval_exten_read(), and pbx_parseable_goto().

pbx_parseable_goto()

static int pbx_parseable_goto ( struct ast_channel *  chan, const char *  goto_string, int  async  )

static

Definition at line 8832 of file pbx.c.

{
    char *exten, *pri, *context;
    char *stringp;
    int ipri;
    int mode = 0;
    char rest[2] = "";
 
    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 (pbx_parse_location(chan, &context, &exten, &pri, &ipri, &mode, rest)) {
        return -1;
    }
    /* 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;
 
}

References ast_async_goto(), ast_channel_priority(), ast_explicit_goto(), ast_log, ast_strdupa, ast_strlen_zero(), voicemailpwcheck::context, ast_channel::exten, LOG_WARNING, pbx_parse_location(), and strsep().

Referenced by ast_async_parseable_goto(), and ast_parseable_goto().

pbx_set_autofallthrough()

int pbx_set_autofallthrough

(

int

newval

)

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

Definition at line 4770 of file pbx.c.

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

References autofallthrough.

Referenced by pbx_load_module().

pbx_set_extenpatternmatchnew()

int pbx_set_extenpatternmatchnew

(

int

newval

)

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

Definition at line 4777 of file pbx.c.

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

References extenpatternmatchnew.

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

pbx_set_overrideswitch()

void pbx_set_overrideswitch

(

const char *

newval

)

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

Since

1.6.1

Definition at line 4784 of file pbx.c.

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

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

Referenced by pbx_load_module().

pbx_shutdown()

static void pbx_shutdown ( void  )

static

Definition at line 8916 of file pbx.c.

{
    STASIS_MESSAGE_TYPE_CLEANUP(hint_change_message_type);
    STASIS_MESSAGE_TYPE_CLEANUP(hint_remove_message_type);
 
    if (hints) {
        ao2_container_unregister("hints");
        ao2_ref(hints, -1);
        hints = NULL;
    }
    if (hintdevices) {
        ao2_container_unregister("hintdevices");
        ao2_ref(hintdevices, -1);
        hintdevices = NULL;
    }
    if (autohints) {
        ao2_container_unregister("autohints");
        ao2_ref(autohints, -1);
        autohints = NULL;
    }
    if (statecbs) {
        ao2_container_unregister("statecbs");
        ao2_ref(statecbs, -1);
        statecbs = NULL;
    }
    if (contexts_table) {
        ast_hashtab_destroy(contexts_table, NULL);
    }
}

References ao2_container_unregister(), ao2_ref, ast_hashtab_destroy(), autohints, contexts_table, hintdevices, NULL, STASIS_MESSAGE_TYPE_CLEANUP, and statecbs.

Referenced by ast_pbx_init().

pbx_thread()

static void * pbx_thread ( void *  data )

static

Definition at line 4688 of file pbx.c.

{
    /* Oh joyous 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;
}

References __ast_pbx_run(), c, ast_channel::data, decrease_call_count(), and NULL.

Referenced by ast_pbx_start().

presence_state_cb()

static void presence_state_cb ( void *  unused, struct stasis_subscription *  sub, struct stasis_message *  msg  )

static

Definition at line 8294 of file pbx.c.

{
    struct ast_presence_state_message *presence_state;
    struct ast_str *hint_app = NULL;
    struct ast_hintdevice *device;
    struct ast_hintdevice *cmpdevice;
    struct ao2_iterator *dev_iter;
 
    if (stasis_message_type(msg) != ast_presence_state_message_type()) {
        return;
    }
 
    presence_state = stasis_message_data(msg);
 
    if (ao2_container_count(hintdevices) == 0) {
        /* There are no hints monitoring devices. */
        return;
    }
 
    hint_app = ast_str_create(1024);
    if (!hint_app) {
        return;
    }
 
    cmpdevice = ast_alloca(sizeof(*cmpdevice) + strlen(presence_state->provider));
    strcpy(cmpdevice->hintdevice, presence_state->provider);
 
    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);
        return;
    }
 
    for (; (device = ao2_iterator_next(dev_iter)); ao2_t_ref(device, -1, "Next device")) {
        if (device->hint) {
            presence_state_notify_callbacks(device->hint, &hint_app, presence_state);
        }
    }
    ao2_iterator_destroy(dev_iter);
    ast_mutex_unlock(&context_merge_lock);
 
    ast_free(hint_app);
}

References ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_next, ao2_t_callback, ao2_t_ref, ast_alloca, ast_free, ast_mutex_lock, ast_mutex_unlock, ast_presence_state_message_type(), ast_str_create, context_merge_lock, ast_hintdevice::hint, ast_hintdevice::hintdevice, hintdevice_cmp_multiple(), hintdevices, NULL, OBJ_MULTIPLE, OBJ_POINTER, presence_state_notify_callbacks(), stasis_message_data(), and stasis_message_type().

Referenced by load_pbx().

presence_state_notify_callbacks()

static void presence_state_notify_callbacks ( struct ast_hint *  hint, struct ast_str **  hint_app, struct ast_presence_state_message *  presence_state  )

static

Definition at line 3464 of file pbx.c.

{
    struct ao2_iterator cb_iter;
    struct ast_state_cb *state_cb;
    char context_name[AST_MAX_CONTEXT];
    char exten_name[AST_MAX_EXTENSION];
 
    ao2_lock(hint);
    if (!hint->exten) {
        /* The extension has already been destroyed */
        ao2_unlock(hint);
        return;
    }
 
    /*
     * 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);
 
    /* Check to see if update is necessary */
    if ((hint->last_presence_state == presence_state->state) &&
        ((hint->last_presence_subtype && presence_state->subtype &&
          !strcmp(hint->last_presence_subtype, presence_state->subtype)) ||
         (!hint->last_presence_subtype && !presence_state->subtype)) &&
        ((hint->last_presence_message && presence_state->message &&
          !strcmp(hint->last_presence_message, presence_state->message)) ||
         (!hint->last_presence_message && !presence_state->message))) {
        /* this update is the same as the last, do nothing */
        return;
    }
 
    /* update new values */
    ast_free(hint->last_presence_subtype);
    ast_free(hint->last_presence_message);
    hint->last_presence_state = presence_state->state;
    hint->last_presence_subtype = presence_state->subtype ? ast_strdup(presence_state->subtype) : NULL;
    hint->last_presence_message = presence_state->message ? ast_strdup(presence_state->message) : NULL;
 
    /* 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_cleanup(state_cb)) {
        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);
}

References ao2_cleanup, ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, 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_str_set(), ast_strdup, ast_hint::callbacks, ast_state_cb::change_cb, context_name, ast_state_cb::data, execute_state_callback(), ast_hint::exten, exten_name, ast_hint::last_presence_message, ast_hint::last_presence_state, ast_hint::last_presence_subtype, NULL, ast_presence_state_message::state, and statecbs.

Referenced by handle_hint_change_message_type(), and presence_state_cb().

print_autohint_key()

static void print_autohint_key ( void *  v_obj, void *  where, ao2_prnt_fn *  prnt  )

static

Definition at line 8969 of file pbx.c.

{
    struct ast_autohint *autohint = v_obj;
 
    if (!autohint) {
        return;
    }
    prnt(where, "%s", autohint->context);
}

References ast_autohint::context.

Referenced by ast_pbx_init().

print_ext()

static void print_ext ( struct ast_exten *  e, char *  buf, int  buflen  )

static

helper function to print an extension

Definition at line 5438 of file pbx.c.

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

References ast_get_extension_app(), ast_get_extension_app_data(), ast_get_extension_priority(), ast_strlen_zero(), buf, and PRIORITY_HINT.

Referenced by show_dialplan_helper().

print_hintdevices_key()

static void print_hintdevices_key ( void *  v_obj, void *  where, ao2_prnt_fn *  prnt  )

static

Definition at line 8957 of file pbx.c.

{
    struct ast_hintdevice *hintdevice = v_obj;
 
    if (!hintdevice) {
        return;
    }
    prnt(where, "%s => %s@%s", hintdevice->hintdevice,
        ast_get_extension_name(hintdevice->hint->exten),
        ast_get_context_name(ast_get_extension_context(hintdevice->hint->exten)));
}

References ast_get_context_name(), ast_get_extension_context(), ast_get_extension_name(), and ast_hintdevice::hintdevice.

Referenced by ast_pbx_init().

print_hints_key()

static void print_hints_key ( void *  v_obj, void *  where, ao2_prnt_fn *  prnt  )

static

Definition at line 8946 of file pbx.c.

{
    struct ast_hint *hint = v_obj;
 
    if (!hint) {
        return;
    }
    prnt(where, "%s@%s", ast_get_extension_name(hint->exten),
        ast_get_context_name(ast_get_extension_context(hint->exten)));
}

References ast_get_context_name(), ast_get_extension_context(), ast_get_extension_name(), and ast_hint::exten.

Referenced by ast_pbx_init().

print_statecbs_key()

static void print_statecbs_key ( void *  v_obj, void *  where, ao2_prnt_fn *  prnt  )

static

Definition at line 8979 of file pbx.c.

{
    struct ast_state_cb *state_cb = v_obj;
 
    if (!state_cb) {
        return;
    }
    prnt(where, "%d", state_cb->id);
}

References ast_state_cb::id.

Referenced by ast_pbx_init().

publish_hint_change()

static int publish_hint_change ( struct ast_hint *  hint, struct ast_exten *  ne  )

static

Publish a hint changed event

Definition at line 4070 of file pbx.c.

{
    struct stasis_message *message;
 
    if (!hint_change_message_type()) {
        return -1;
    }
 
    if (!(message = stasis_message_create(hint_change_message_type(), hint))) {
        ao2_ref(hint, -1);
        return -1;
    }
 
    stasis_publish(ast_device_state_topic_all(), message);
    stasis_publish(ast_presence_state_topic_all(), message);
 
    ao2_ref(message, -1);
 
    return 0;
}

References ao2_ref, ast_device_state_topic_all(), ast_presence_state_topic_all(), stasis_message_create(), and stasis_publish().

Referenced by ast_change_hint().

publish_hint_remove()

static int publish_hint_remove ( struct ast_hint *  hint )

static

Publish a hint removed event

Definition at line 3920 of file pbx.c.

{
    struct stasis_message *message;
 
    if (!hint_remove_message_type()) {
        return -1;
    }
 
    if (!(message = stasis_message_create(hint_remove_message_type(), hint))) {
        ao2_ref(hint, -1);
        return -1;
    }
 
    stasis_publish(ast_device_state_topic_all(), message);
 
    ao2_ref(message, -1);
 
    return 0;
}

References ao2_ref, ast_device_state_topic_all(), stasis_message_create(), and stasis_publish().

Referenced by ast_remove_hint().

raise_exception()

int raise_exception	(	struct ast_channel *	chan,
		const char *	reason,
		int	priority
	)

pbx.c functions needed by pbx_builtins.c

Definition at line 2806 of file pbx.c.

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

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, voicemailpwcheck::context, ast_datastore::data, exception_store_info, pbx_exception::exten, NULL, priority, pbx_exception::priority, pbx_exception::reason, and set_ext_pri().

Referenced by __ast_pbx_run(), pbx_builtin_raise_exception(), and pbx_builtin_waitexten().

remove_hintdevice()

static int remove_hintdevice ( struct ast_hint *  hint )

static

Definition at line 524 of file pbx.c.

{
    while (AST_VECTOR_SIZE(&hint->devices) > 0) {
        char *device = AST_VECTOR_GET(&hint->devices, 0);
 
        ao2_t_callback_data(hintdevices, OBJ_SEARCH_KEY | OBJ_UNLINK | OBJ_NODATA,
            hintdevice_remove_cb, device, hint, "Remove device from container");
        AST_VECTOR_REMOVE_UNORDERED(&hint->devices, 0);
        ast_free(device);
    }
 
    return 0;
}

References ao2_t_callback_data, ast_free, AST_VECTOR_GET, AST_VECTOR_REMOVE_UNORDERED, AST_VECTOR_SIZE, ast_hint::devices, hintdevice_remove_cb(), hintdevices, OBJ_NODATA, OBJ_SEARCH_KEY, and OBJ_UNLINK.

Referenced by ast_change_hint(), and ast_remove_hint().

set_ext_pri()

void set_ext_pri	(	struct ast_channel *	c,
		const char *	exten,
		int	pri
	)

helper function to set extension and priority

Definition at line 4264 of file pbx.c.

{
    ast_channel_lock(c);
    ast_channel_exten_set(c, exten);
    ast_channel_priority_set(c, pri);
    ast_channel_unlock(c);
}

References ast_channel_exten_set(), ast_channel_lock, ast_channel_priority_set(), ast_channel_unlock, c, and ast_exten::exten.

Referenced by __ast_pbx_run(), pbx_builtin_waitexten(), and raise_exception().

show_debug_helper()

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

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

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(), c, cli_match_char_tree(), voicemailpwcheck::context, dialplan_counters::context_existence, test_val::name, NULL, dialplan_counters::total_context, and dialplan_counters::total_exten.

Referenced by handle_debug_dialplan().

show_dialplan_helper()

static int show_dialplan_helper ( int  fd, const char *  context, const char *  exten, struct dialplan_counters *  dpc, const struct ast_include *  rinclude, int  includecount, const char *  includes[]  )

static

Definition at line 5467 of file pbx.c.

{
    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)) ) {
        int idx;
        struct ast_exten *e;
#ifndef LOW_MEMORY
        char buf[1024], buf2[1024];
#else
        char buf[256], buf2[256];
#endif
        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));
            if (c->autohints) {
                ast_cli(fd, "Autohints support enabled\n");
            }
            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));
                    if (c->autohints) {
                        ast_cli(fd, "Autohints support enabled\n");
                    }
                }
                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));
 
            show_dialplan_helper_extension_output(fd, buf, buf2, 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));
 
                show_dialplan_helper_extension_output(fd, buf, buf2, p);
            }
        }
 
        /* walk included and write info ... */
        for (idx = 0; idx < ast_context_includes_count(c); idx++) {
            const struct ast_include *i = ast_context_includes_get(c, idx);
 
            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 ... */
        for (idx = 0; idx < ast_context_ignorepats_count(c); idx++) {
            const struct ast_ignorepat *ip = ast_context_ignorepats_get(c, idx);
            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) {
            for (idx = 0; idx < ast_context_switches_count(c); idx++) {
                const struct ast_sw *sw = ast_context_switches_get(c, idx);
 
                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;
}

References ast_cli(), ast_context_ignorepats_count(), ast_context_ignorepats_get(), ast_context_includes_count(), ast_context_includes_get(), ast_context_switches_count(), ast_context_switches_get(), 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_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_contexts(), ast_walk_extension_priorities(), buf, buf2, c, ast_exten::cidmatch, voicemailpwcheck::context, dialplan_counters::context_existence, el, ast_exten::exten, dialplan_counters::extension_existence, LOG_WARNING, ast_exten::matchcid, NULL, print_ext(), show_dialplan_helper(), show_dialplan_helper_extension_output(), dialplan_counters::total_context, dialplan_counters::total_exten, and dialplan_counters::total_prio.

Referenced by handle_show_dialplan(), and show_dialplan_helper().

show_dialplan_helper_extension_output()

static void show_dialplan_helper_extension_output ( int  fd, char *  buf1, char *  buf2, struct ast_exten *  exten  )

static

Writes CLI output of a single extension for show dialplan.

Definition at line 5452 of file pbx.c.

{
    if (ast_get_extension_registrar_file(exten)) {
        ast_cli(fd, "  %-17s %-45s [%s:%d]\n",
            buf1, buf2,
            ast_get_extension_registrar_file(exten),
            ast_get_extension_registrar_line(exten));
        return;
    }
 
    ast_cli(fd, "  %-17s %-45s [%s]\n",
        buf1, buf2, ast_get_extension_registrar(exten));
}

References ast_cli(), ast_get_extension_registrar(), ast_get_extension_registrar_file(), ast_get_extension_registrar_line(), buf1, and buf2.

Referenced by show_dialplan_helper().

STASIS_MESSAGE_TYPE_DEFN_LOCAL() [1/2]

STASIS_MESSAGE_TYPE_DEFN_LOCAL

(

hint_change_message_type

)

STASIS_MESSAGE_TYPE_DEFN_LOCAL() [2/2]

STASIS_MESSAGE_TYPE_DEFN_LOCAL

(

hint_remove_message_type

)

statecbs_cmp()

static int statecbs_cmp ( void *  obj, void *  arg, int  flags  )

static

Definition at line 8904 of file pbx.c.

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

References ast_state_cb::change_cb, CMP_MATCH, and CMP_STOP.

Referenced by ast_pbx_init().

trie_find_next_match()

static struct ast_exten * trie_find_next_match ( struct match_char *  node )

static

Definition at line 1165 of file pbx.c.

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

References match_char::alt_char, match_char::exten, NULL, and trie_find_next_match().

Referenced by pbx_find_extension(), and trie_find_next_match().

unload_pbx()

static void unload_pbx ( void  )

static

Definition at line 8409 of file pbx.c.

{
    presence_state_sub = stasis_unsubscribe_and_join(presence_state_sub);
    device_state_sub = stasis_unsubscribe_and_join(device_state_sub);
 
    ast_manager_unregister("ShowDialPlan");
    ast_manager_unregister("ExtensionStateList");
    ast_cli_unregister_multiple(pbx_cli, ARRAY_LEN(pbx_cli));
    ast_custom_function_unregister(&exception_function);
    ast_custom_function_unregister(&testtime_function);
}

References ARRAY_LEN, ast_cli_unregister_multiple(), ast_custom_function_unregister(), ast_manager_unregister(), device_state_sub, exception_function, pbx_cli, presence_state_sub, stasis_unsubscribe_and_join(), and testtime_function.

Referenced by load_pbx().

unreference_cached_app()

void unreference_cached_app

(

struct ast_app *

app

)

pbx.c function needed by pbx_app.c

Definition at line 6130 of file pbx.c.

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

References app, ast_rdlock_contexts(), ast_unlock_contexts(), ast_walk_context_extensions(), ast_walk_contexts(), ast_walk_extension_priorities(), voicemailpwcheck::context, and NULL.

Referenced by ast_unregister_application().

update_scoreboard()

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

{
    /* 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
}

References ast_log, 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().

wait_for_hangup()

void wait_for_hangup	(	struct ast_channel *	chan,
		const void *	data
	)

Definition at line 8228 of file pbx.c.

{
    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_without_silence(chan, waittime);
    } else do {
        res = ast_waitfor(chan, -1);
        if (res < 0)
            return;
        f = ast_read(chan);
        if (f)
            ast_frfree(f);
    } while(f);
}

References ast_frfree, ast_read(), ast_safe_sleep_without_silence(), ast_strlen_zero(), ast_waitfor(), and ast_frame::data.

Referenced by indicate_busy(), and indicate_congestion().

Variable Documentation

autofallthrough

int autofallthrough = 1

static

Definition at line 768 of file pbx.c.

Referenced by __ast_pbx_run(), and pbx_set_autofallthrough().

autohints

struct ao2_container* autohints

static

Container for autohint contexts.

Definition at line 387 of file pbx.c.

Referenced by ast_pbx_init(), context_table_create_autohints(), device_state_cb(), and pbx_shutdown().

conlock

ast_mutex_t conlock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }

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

Referenced by ast_rdlock_contexts(), ast_unlock_contexts(), and ast_wrlock_contexts().

context_merge_lock

ast_mutex_t context_merge_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }

static

Lock to hold off restructuring of hints by ast_merge_contexts_and_delete.

Definition at line 795 of file pbx.c.

Referenced by ast_change_hint(), ast_merge_contexts_and_delete(), device_state_cb(), and presence_state_cb().

contexts

struct ast_context* contexts

static

Definition at line 781 of file pbx.c.

Referenced by __ast_context_destroy(), ast_context_destroy(), ast_context_find_or_create(), ast_merge_contexts_and_delete(), AST_TEST_DEFINE(), and ast_walk_contexts().

contexts_table

struct ast_hashtab* contexts_table = NULL

static

Definition at line 782 of file pbx.c.

Referenced by ast_context_destroy(), ast_context_find(), ast_context_find_or_create(), ast_merge_contexts_and_delete(), find_context(), find_context_locked(), and pbx_shutdown().

countcalls

int countcalls

static

Definition at line 778 of file pbx.c.

Referenced by ast_active_calls(), decrease_call_count(), and increase_call_count().

device_state_sub

struct stasis_subscription* device_state_sub

static

Subscription for device state change events.

Definition at line 773 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

exception_function

struct ast_custom_function exception_function

static

Initial value:

= {
    .name = "EXCEPTION",
    .read = acf_exception_read,
}

Definition at line 2852 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

exception_store_info

const struct ast_datastore_info exception_store_info

static

Initial value:

= {
    .type = "EXCEPTION",
    .destroy = exception_store_free,
}

Definition at line 2790 of file pbx.c.

Referenced by acf_exception_read(), and raise_exception().

extenpatternmatchnew

int extenpatternmatchnew = 0

static

Definition at line 769 of file pbx.c.

Referenced by pbx_find_extension(), and pbx_set_extenpatternmatchnew().

extension_states

const struct cfextension_states extension_states[]

static

Referenced by ast_extension_state2str().

extensionstate_buf

struct ast_threadstorage extensionstate_buf = { .once = PTHREAD_ONCE_INIT , .key_init = __init_extensionstate_buf , .custom_init = NULL , }

static

Definition at line 229 of file pbx.c.

Referenced by ast_extension_state2(), and extension_presence_state_helper().

hintdevice_data

struct ast_threadstorage hintdevice_data = { .once = PTHREAD_ONCE_INIT , .key_init = __init_hintdevice_data , .custom_init = NULL , }

static

Definition at line 359 of file pbx.c.

Referenced by add_hintdevice().

hintdevices

struct ao2_container* hintdevices

static

Container for hint devices.

Definition at line 370 of file pbx.c.

Referenced by add_hintdevice(), ast_pbx_init(), device_state_cb(), pbx_shutdown(), presence_state_cb(), and remove_hintdevice().

hints

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

Referenced by lua_register_hints(), and pvalExtenSetHints().

maxcalllock

ast_mutex_t maxcalllock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }

static

Definition at line 777 of file pbx.c.

Referenced by decrease_call_count(), and increase_call_count().

overrideswitch

char* overrideswitch = NULL

static

Definition at line 770 of file pbx.c.

Referenced by handle_cli_dialplan_save(), pbx_find_extension(), and pbx_set_overrideswitch().

pbx_cli

struct ast_cli_entry pbx_cli[]

static

Definition at line 6115 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

presence_state_sub

struct stasis_subscription* presence_state_sub

static

Subscription for presence state change events.

Definition at line 775 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

statecbs

struct ao2_container* statecbs

static

Definition at line 808 of file pbx.c.

Referenced by ast_add_hint(), ast_extension_state_del(), ast_pbx_init(), device_state_notify_callbacks(), extension_state_add_destroy(), pbx_shutdown(), and presence_state_notify_callbacks().

stateid

int stateid = 1

static

Definition at line 797 of file pbx.c.

Referenced by extension_state_add_destroy().

switch_data

struct ast_threadstorage switch_data = { .once = PTHREAD_ONCE_INIT , .key_init = __init_switch_data , .custom_init = NULL , }

static

Definition at line 228 of file pbx.c.

Referenced by pbx_find_extension().

testtime_function

struct ast_custom_function testtime_function

static

Initial value:

= {
    .name = "TESTTIME",
    .write = testtime_write,
}

Definition at line 8277 of file pbx.c.

Referenced by load_pbx(), and unload_pbx().

totalcalls

int totalcalls

static

Definition at line 779 of file pbx.c.

Referenced by ast_processed_calls(), increase_call_count(), and timing_read().