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 - must remain in sync with fake_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	fake_context
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	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_lockmacro (const char *context)
	locks the macrolock in the given context More...
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)
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_unlockmacro (const char *context)
	Unlocks the macrolock in the given context. More...
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 *data)
	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)
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_device2extenstate (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...
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 1229 of file pbx.c.

BITS_PER

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

Referenced by ext_cmp_pattern_pos().

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.

Referenced by pbx_extension_helper().

HASH_EXTENHINT_SIZE

#define HASH_EXTENHINT_SIZE   563

Definition at line 358 of file pbx.c.

Referenced by ast_pbx_init().

HINTDEVICE_DATA_LENGTH

#define HINTDEVICE_DATA_LENGTH   16

Definition at line 351 of file pbx.c.

INC_DST_OVERFLOW_CHECK

#define INC_DST_OVERFLOW_CHECK

Referenced by get_pattern_node().

MORE

#define MORE

(

s

)

(*candidate_exten_advance(s))

Definition at line 1228 of file pbx.c.

NEW_MATCHER_CHK_MATCH

#define NEW_MATCHER_CHK_MATCH

Referenced by new_find_extension().

NEW_MATCHER_RECURSE

#define NEW_MATCHER_RECURSE

Referenced by new_find_extension().

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

Referenced by pbx_extension_helper(), and pbx_find_extension().

STATUS_NO_EXTENSION

#define STATUS_NO_EXTENSION   2

Definition at line 2468 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

STATUS_NO_LABEL

#define STATUS_NO_LABEL   4

Definition at line 2470 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

STATUS_NO_PRIORITY

#define STATUS_NO_PRIORITY   3

Definition at line 2469 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

STATUS_SUCCESS

#define STATUS_SUCCESS   5

Definition at line 2471 of file pbx.c.

Referenced by pbx_find_extension().

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

References __ast_internal_context_destroy(), ast_context::alts, 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, ast_exten::exten, ignorepat_free(), ast_context::ignorepats, include_free(), ast_context::includes, ast_exten::matchcid, ast_exten::name, ast_context::name, ast_exten::next, ast_context::next, NULL, ast_exten::peer_table, ast_exten::priority, ast_context::refcount, ast_exten::registrar, ast_context::registrar, ast_context::root, ast_context::root_table, sw_free(), and tmp().

Referenced by ast_context_destroy(), and ast_context_set_autohints().

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

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

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

Referenced by ast_async_goto_if_exists(), and ast_goto_if_exists().

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

 if (!chan)
 return -2;

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

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

__ast_internal_context_destroy()

static void __ast_internal_context_destroy ( struct ast_context *  con )

static

Definition at line 8050 of file pbx.c.

References ast_context::alts, ast_free, ast_hashtab_destroy(), ast_mutex_destroy, ast_rwlock_destroy, AST_VECTOR_CALLBACK_VOID, AST_VECTOR_FREE, destroy_exten(), destroy_pattern_tree(), el, ignorepat_free(), ast_context::ignorepats, include_free(), ast_context::includes, ast_context::lock, ast_context::macrolock, ast_exten::next, NULL, ast_context::pattern_tree, ast_exten::peer, ast_context::registrar, ast_context::root, ast_context::root_table, sw_free(), and tmp().

Referenced by __ast_context_destroy(), and ast_merge_contexts_and_delete().

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

 if (tmp->registrar)
 ast_free(tmp->registrar);

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

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

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

References 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, collect_digits(), digit, ast_pbx::dtimeoutms, error(), indicate_busy(), indicate_congestion(), LOG_WARNING, ast_pbx_args::no_hangup_chan, NULL, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), pbx_destroy(), raise_exception(), ast_pbx::rtimeoutms, S_COR, set_ext_pri(), status, and timeout.

Referenced by ast_pbx_run_args(), and pbx_thread().

{
 int found = 0; /* set if we find at least one match */
 int res = 0;
 int autoloopflag;
 int error = 0; /* set an error conditions */
 struct ast_pbx *pbx;
 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;
}

__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 352 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 2209 of file pbx.c.

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

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

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.

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

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

action_extensionstatelist()

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

static

Definition at line 8383 of file pbx.c.

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

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

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

References add_pattern_node(), already_in_tree(), ARRAY_LEN, ast_copy_string(), ast_debug, ast_log, buf, pattern_node::buf, ast_exten::cidmatch, match_char::deleted, ast_exten::exten, match_char::exten, get_pattern_node(), LOG_ERROR, LOG_WARNING, ast_exten::matchcid, 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().

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

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

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

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

 /* See about adding node to tree. */
 m2 = NULL;
 if (already && (m2 = already_in_tree(m1, pat_node[idx_cur].buf, pattern))
 && m2->next_char) {
 if (!pat_node[idx_next].buf[0]) {
 /*
 * This is the end of the pattern, but not the end of the tree.
 * Mark this node with the exten... a shorter pattern might win
 * if the longer one doesn't match.
 */
 if (findonly) {
 return m2;
 }
 if (m2->exten) {
 ast_log(LOG_WARNING, "Found duplicate exten. Had %s found %s\n",
 m2->deleted ? "(deleted/invalid)" : m2->exten->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;
}

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

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_hintdevice::hint, ast_hintdevice::hintdevice, hintdevice_data, hintdevice_destroy(), parse(), str, and strsep().

Referenced by ast_add_hint(), and ast_change_hint().

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

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

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

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

Referenced by add_exten_to_pattern_tree().

{
 struct match_char *m;

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

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

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

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

 return m;
}

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

References add_exten_to_pattern_tree(), ast_add_hint(), ast_change_hint(), ast_free, ast_hashtab_insert_safe, ast_hashtab_remove_object_via_lookup(), ast_log, match_char::exten, 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, ast_context::root, ast_context::root_table, tmp(), and match_char::x.

Referenced by ast_add_extension2_lockopt().

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

 for (ep = NULL; e ; ep = e, e = e->peer) {
 if (e->label && tmp->label && e->priority != tmp->priority && !strcmp(e->label, tmp->label)) {
 if (strcmp(e->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;
}

alloc_device_state_info()

static struct ao2_container* alloc_device_state_info ( void  )

static

Definition at line 3076 of file pbx.c.

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_container_alloc_list, and NULL.

Referenced by ast_extension_state_extended(), and device_state_notify_callbacks().

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

already_in_tree()

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

static

Definition at line 1397 of file pbx.c.

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

Referenced by add_exten_to_pattern_tree().

{
 struct match_char *t;

 if (!current) {
 return 0;
 }

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

 return 0;
}

ast_active_calls()

int ast_active_calls

(

void

)

Retrieve the number of active calls.

Definition at line 4764 of file pbx.c.

References countcalls.

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

{
 return countcalls;
}

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

References ast_add_extension2(), ast_unlock_contexts(), c, ast_exten::datad, find_context_locked(), and NULL.

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_exten(), register_extension(), register_peer_exten(), sla_build_station(), and sla_build_trunk().

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

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

References ast_add_extension2_lockopt(), and ast_exten::datad.

Referenced by ast_add_extension(), and context_merge().

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

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

References add_exten_to_pattern_tree(), add_priority(), ast_exten::app, ast_add_hint(), ast_calloc, ast_channel_context_set(), ast_channel_exten_set(), ast_channel_unref, ast_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::cidmatch_display, ast_exten::data, ast_exten::datad, DEBUG_ATLEAST, match_char::deleted, el, errno, ext_cmp(), ext_fluff_count(), ext_strncpy(), ast_exten::exten, match_char::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_exten::name, ast_context::name, ast_exten::next, NULL, ast_exten::parent, ast_context::pattern_tree, pbx_substitute_variables_helper(), ast_exten::peer_label_table, ast_exten::peer_table, ast_exten::priority, PRIORITY_HINT, ast_exten::registrar, ast_exten::registrar_file, ast_exten::registrar_line, ast_context::root, ast_context::root_table, ast_exten::stuff, tmp(), VAR_BUF_SIZE, and match_char::x.

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

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

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

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

References ast_add_extension2_lockopt(), and ast_exten::datad.

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

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

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

References ast_add_extension2_lockopt(), c, ast_exten::datad, find_context(), and NULL.

Referenced by ast_merge_contexts_and_delete().

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

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

 return ret;
}

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

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

Referenced by add_priority(), and ast_add_extension2_lockopt().

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

 if (!e) {
 return -1;
 }

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

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

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, and LOG_WARNING.

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(), handle_request_bye(), my_handle_dtmf(), onModeChanged(), ooh323_rtp_read(), pbx_parseable_goto(), process_ast_dsp(), process_sdp(), and sip_read().

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

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

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

{
 struct ast_channel *chan;
 int res = -1;

 if ((chan = ast_channel_get_by_name(channame))) {
 res = ast_async_goto(chan, context, exten, priority);
 chan = ast_channel_unref(chan);
 }

 return res;
}

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

References __ast_goto_if_exists().

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

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

References pbx_parseable_goto().

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

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

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 serach within
exten	extension to check
priority	priority of extension path
callerid	callerid of extension being searched for

Note

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

Returns

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

Definition at line 4194 of file pbx.c.

References E_CANMATCH, NULL, and pbx_extension_helper().

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

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

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

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

Referenced by add_priority().

{
 struct ast_hint *hint;

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

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

 /*
 * Unlink the hint from the hints container as the extension
 * name (which is the hash value) could change.
 */
 hint = ao2_find(hints, oe, OBJ_UNLINK);
 if (!hint) {
 ao2_unlock(hints);
 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;
}

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 ignorpattern to
ignorepat	ignorepattern to set up for the extension
registrar	registrar of the ignore pattern

Adds an ignore pattern to a particular context.

Return values

0	on success
-1	on failure

Definition at line 6877 of file pbx.c.

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

Referenced by handle_cli_dialplan_add_ignorepat().

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

 c = find_context_locked(context);
 if (c) {
 ret = ast_context_add_ignorepat2(c, value, registrar);
 ast_unlock_contexts();
 }
 return ret;
}

ast_context_add_ignorepat2()

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

Definition at line 6890 of file pbx.c.

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(), and ast_context::ignorepats.

Referenced by ast_context_add_ignorepat(), and context_merge_incls_swits_igps_other_registrars().

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

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

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

Referenced by AST_TEST_DEFINE(), and handle_cli_dialplan_add_include().

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

 c = find_context_locked(context);
 if (c) {
 ret = ast_context_add_include2(c, include, registrar);
 ast_unlock_contexts();
 }
 return ret;
}

ast_context_add_include2()

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

Add a context include.

Parameters

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

Adds an include taking a struct ast_context as the first parameter

Return values

0	on success
-1	on failure

Definition at line 6726 of file pbx.c.

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(), and ast_context::includes.

Referenced by ast_context_add_include(), and context_merge_incls_swits_igps_other_registrars().

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

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

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

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

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

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

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(), errno, sw_alloc(), and sw_free().

Referenced by ast_context_add_switch(), and context_merge_incls_swits_igps_other_registrars().

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

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.

Returns

nothing

Definition at line 8260 of file pbx.c.

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

Referenced by ast_context_destroy_by_name().

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

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

References ast_context_destroy(), ast_context_find(), ast_unlock_contexts(), and ast_wrlock_contexts().

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

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

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

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

Referenced by _macro_exec(), app_create(), ast_context_destroy_by_name(), ast_context_verify_includes(), ast_ignore_pattern(), handle_cli_dialplan_add_extension(), handle_cli_dialplan_add_include(), isexten_function_read(), register_exten(), register_peer_exten(), and unregister_exten().

{
 struct ast_context *tmp;
 struct fake_context item;

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

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

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

Referenced by context_merge().

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

 if (!contexts_table) {
 /* Protect creation of contexts_table from reentrancy. */
 ast_wrlock_contexts();
 if (!contexts_table) {
 contexts_table = ast_hashtab_create(17,
 ast_hashtab_compare_contexts,
 ast_hashtab_resize_java,
 ast_hashtab_newsize_java,
 ast_hashtab_hash_contexts,
 0);
 }
 ast_unlock_contexts();
 }

 ast_copy_string(search.name, name, sizeof(search.name));
 if (!extcontexts) {
 ast_rdlock_contexts();
 local_contexts = &contexts;
 tmp = ast_hashtab_lookup(contexts_table, &search);
 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);
 ast_mutex_init(&tmp->macrolock);
 strcpy(tmp->name, name);
 tmp->root = NULL;
 tmp->root_table = NULL;
 tmp->registrar = ast_strdup(registrar);
 AST_VECTOR_INIT(&tmp->includes, 0);
 AST_VECTOR_INIT(&tmp->ignorepats, 0);
 AST_VECTOR_INIT(&tmp->alts, 0);
 tmp->refcount = 1;
 } 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;
}

ast_context_ignorepats_count()

int ast_context_ignorepats_count

(

const struct ast_context *

con

)

Definition at line 8740 of file pbx.c.

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

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

ast_context_ignorepats_get()

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

Definition at line 8745 of file pbx.c.

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

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

ast_context_includes_count()

int ast_context_includes_count

(

const struct ast_context *

con

)

Definition at line 8697 of file pbx.c.

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

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

ast_context_includes_get()

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

Definition at line 8702 of file pbx.c.

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

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

ast_context_lockmacro()

int ast_context_lockmacro

(

const char *

context

)

locks the macrolock in the given context

Note

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

Parameters

context

The context

Definition at line 5162 of file pbx.c.

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

Referenced by _macro_exec().

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

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

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

 return ret;
}

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

References ast_context_remove_extension_callerid(), AST_EXT_MATCHCID_ANY, and NULL.

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

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

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

References ast_context_remove_extension_callerid2(), AST_EXT_MATCHCID_ANY, and NULL.

Referenced by add_extension(), and add_hints().

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

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

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

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

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

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

References add_exten_to_pattern_tree(), ast_hashtab_insert_immediate, ast_hashtab_lookup(), ast_hashtab_remove_this_object(), ast_hashtab_size(), ast_log, ast_strlen_zero, ast_unlock_context(), ast_verb, ast_wrlock_context(), ast_exten::cidmatch, match_char::deleted, destroy_exten(), 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, ast_exten::priority, ast_exten::registrar, ast_context::root, ast_context::root_table, and match_char::x.

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

{
 struct ast_exten *exten, *prev_exten = NULL;
 struct ast_exten *peer;
 struct ast_exten ex, *exten2, *exten3;
 char dummy_name[1024];
 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_log(LOG_ERROR,"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;
}

ast_context_remove_ignorepat()

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

Definition at line 6837 of file pbx.c.

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

Referenced by handle_cli_dialplan_remove_ignorepat().

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

 c = find_context_locked(context);
 if (c) {
 ret = ast_context_remove_ignorepat2(c, ignorepat, registrar);
 ast_unlock_contexts();
 }
 return ret;
}

ast_context_remove_ignorepat2()

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

Definition at line 6850 of file pbx.c.

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(), and ast_context::ignorepats.

Referenced by ast_context_remove_ignorepat().

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

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

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

Referenced by handle_cli_dialplan_remove_include().

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

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

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

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(), and ast_context::includes.

Referenced by ast_context_remove_include().

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

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 rigt context structure, leave context list locked and call ast_context_remove_switch2 which removes switch, unlock contexts list and return ...

Definition at line 4898 of file pbx.c.

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

{
 int ret = -1; /* default error return */
 struct ast_context *c;

 c = find_context_locked(context);
 if (c) {
 /* remove switch from this context ... */
 ret = ast_context_remove_switch2(c, sw, data, registrar);
 ast_unlock_contexts();
 }
 return ret;
}

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

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

Referenced by ast_context_remove_switch().

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

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

References __ast_context_destroy(), ast_context::autohints, enabled, and ast_exten::registrar.

Referenced by pbx_load_config().

{
 con->autohints = enabled;
}

ast_context_switches_count()

int ast_context_switches_count

(

const struct ast_context *

con

)

Definition at line 8652 of file pbx.c.

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

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

ast_context_switches_get()

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

Definition at line 8657 of file pbx.c.

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

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

ast_context_unlockmacro()

int ast_context_unlockmacro

(

const char *

context

)

Unlocks the macrolock in the given context.

Note

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

Parameters

context

The context

Definition at line 5184 of file pbx.c.

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

Referenced by _macro_exec().

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

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

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

 return ret;
}

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

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

{
 int idx;
 int res = 0;

 for (idx = 0; idx < ast_context_includes_count(con); 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;
}

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.

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(), AST_TEST_DEFINE(), and handle_show_device2extenstate().

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

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

References E_MATCH, NULL, and pbx_extension_helper().

Referenced by __analog_ss_thread(), __ast_goto_if_exists(), __ast_pbx_run(), _macro_exec(), 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(), cb_events(), chan_pjsip_cng_tone_detected(), cli_console_dial(), comeback_goto(), conf_run(), console_dial(), dahdi_handle_dtmf(), dial_exec_full(), dialplan_has_destination_cb(), disa_exec(), dp_lookup(), dundi_lookup_local(), fax_detect_framehook(), findmeexec(), get_also_info(), get_destination(), get_refer_info(), gosub_exec(), handle_clear_alarms(), handle_gosub(), isexten_function_read(), jingle_new(), join_conference_bridge(), key_dial_page(), leave_voicemail(), local_call(), local_devicestate(), loopback_exists(), mgcp_ss(), minivm_greet_exec(), misdn_overlap_dial_task(), my_handle_dtmf(), new_subscribe(), onModeChanged(), ooh323_rtp_read(), options_on_rx_request(), pbx_builtin_waitexten(), phone_check_exception(), privacy_exec(), process_ast_dsp(), process_sdp(), readexten_exec(), refer_incoming_attended_request(), refer_incoming_blind_request(), register_peer_exten(), setsubstate(), show_debug_helper(), sip_new(), sip_read(), skinny_dialer(), socket_process_helper(), try_calling(), vm_authenticate(), and waitstream_core().

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

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

References ast_channel_context_set(), ast_channel_exten_set(), ast_channel_flags(), ast_channel_lock, ast_channel_priority_set(), ast_channel_unlock, AST_FLAG_IN_AUTOLOOP, ast_strlen_zero, ast_test_flag, and ast_exten::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().

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

ast_extension_close()

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

Definition at line 2418 of file pbx.c.

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

Referenced by lua_find_extension(), and realtime_switch_common().

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

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

References ext_cmp().

Referenced by lua_extension_cmp().

{
 int cmp;

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

ast_extension_match()

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

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

References E_MATCH, and extension_match_core().

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

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

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.

References internal_extension_state_extended(), and NULL.

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

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

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.

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

Referenced by ast_add_hint(), and internal_extension_state_extended().

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

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

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

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.

References ARRAY_LEN, extension_states, and cfextension_states::text.

Referenced by action_extensionstate(), action_extensionstatelist(), AST_TEST_DEFINE(), exten_state_publisher_state_cb(), extensionstate_update(), handle_request_subscribe(), handle_show_device2extenstate(), handle_show_hint(), handle_show_hints(), manager_state_cb(), show_channels_cb(), skinny_extensionstate_cb(), and to_ami().

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

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.

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

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

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

References extension_state_add_destroy(), and NULL.

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

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

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

References extension_state_add_destroy().

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

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

References extension_state_add_destroy().

Referenced by handle_request_subscribe(), and subscription_established().

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

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

References extension_state_add_destroy(), and NULL.

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

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

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

Referenced by destroy_queue_member_cb(), dialog_unlink_all(), handle_request_subscribe(), skinny_session_cleanup(), subscription_shutdown(), and unload_module().

{
 struct ast_state_cb *p_cur;
 int ret = -1;

 if (!id) { /* id == 0 is a callback without extension */
 if (!change_cb) {
 return ret;
 }
 p_cur = ao2_find(statecbs, change_cb, OBJ_UNLINK);
 if (p_cur) {
 ret = 0;
 ao2_ref(p_cur, -1);
 }
 } else { /* callback with extension, find the callback based on ID */
 struct ast_hint *hint;

 ao2_lock(hints);/* Locked to hold off ast_merge_contexts_and_delete */
 hint = ao2_callback(hints, 0, find_hint_by_cb_id, &id);
 if (hint) {
 p_cur = ao2_find(hint->callbacks, &id, OBJ_UNLINK);
 if (p_cur) {
 ret = 0;
 ao2_ref(p_cur, -1);
 }
 ao2_ref(hint, -1);
 }
 ao2_unlock(hints);
 }

 return ret;
}

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.

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

Referenced by exten_state_data_alloc(), and handle_request_subscribe().

{
 struct ao2_container *container = NULL;
 int ret;

 if (device_state_info) {
 container = alloc_device_state_info();
 }

 ret = internal_extension_state_extended(c, context, exten, container);
 if (ret < 0 && container) {
 ao2_ref(container, -1);
 container = NULL;
 }

 if (device_state_info) {
 get_device_state_causing_channels(container);
 *device_state_info = container;
 }

 return ret;
}

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

References E_FINDLABEL, NULL, and pbx_extension_helper().

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

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

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

References E_FINDLABEL, NULL, and pbx_extension_helper().

Referenced by pbx_load_config().

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

ast_get_context_name()

const char* ast_get_context_name

(

struct ast_context *

con

)

Definition at line 8538 of file pbx.c.

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

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

ast_get_context_registrar()

const char* ast_get_context_registrar

(

struct ast_context *

c

)

Definition at line 8566 of file pbx.c.

References NULL, and ast_context::registrar.

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

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

ast_get_extension_app()

const char* ast_get_extension_app

(

struct ast_exten *

e

)

Definition at line 8596 of file pbx.c.

References ast_exten::app, and NULL.

Referenced by _macro_exec(), add_extension(), ast_add_hint(), ast_change_hint(), ast_extension_state2(), ast_get_hint(), ast_str_get_hint(), check_retrieve_call_extensions(), 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().

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

ast_get_extension_app_data()

void* ast_get_extension_app_data

(

struct ast_exten *

e

)

Definition at line 8601 of file pbx.c.

References ast_exten::data, and NULL.

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

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

ast_get_extension_cidmatch()

const char* ast_get_extension_cidmatch

(

struct ast_exten *

e

)

Definition at line 8591 of file pbx.c.

References ast_exten::cidmatch_display, and NULL.

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

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

ast_get_extension_context()

struct ast_context* ast_get_extension_context

(

struct ast_exten *

exten

)

Definition at line 8543 of file pbx.c.

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

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

ast_get_extension_label()

const char* ast_get_extension_label

(

struct ast_exten *

exten

)

Definition at line 8553 of file pbx.c.

References ast_exten::label, and NULL.

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

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

ast_get_extension_matchcid()

int ast_get_extension_matchcid

(

struct ast_exten *

e

)

Definition at line 8586 of file pbx.c.

References ast_exten::matchcid.

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

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

ast_get_extension_name()

const char* ast_get_extension_name

(

struct ast_exten *

exten

)

Definition at line 8548 of file pbx.c.

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

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

ast_get_extension_priority()

int ast_get_extension_priority

(

struct ast_exten *

exten

)

Definition at line 8558 of file pbx.c.

References ast_exten::priority.

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

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

ast_get_extension_registrar()

const char* ast_get_extension_registrar

(

struct ast_exten *

e

)

Definition at line 8571 of file pbx.c.

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

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

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

References NULL, and ast_exten::registrar_file.

Referenced by show_dialplan_helper_extension_output().

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

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

References ast_exten::registrar_line.

Referenced by show_dialplan_helper_extension_output().

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

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

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

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

{
 struct ast_exten *e = ast_hint_extension(c, context, exten);

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

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

References __ast_goto_if_exists().

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

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

ast_hashtab_compare_contexts()

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

hashtable functions for contexts

Definition at line 683 of file pbx.c.

References bc, and ast_context::name.

Referenced by ast_context_find_or_create().

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

ast_hashtab_hash_contexts()

unsigned int ast_hashtab_hash_contexts

(

const void *

obj

)

Definition at line 735 of file pbx.c.

References ast_hashtab_hash_string(), and ast_context::name.

Referenced by ast_context_find_or_create().

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

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.

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

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

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

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.

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

Referenced by ast_hint_extension(), and ast_merge_contexts_and_delete().

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

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.

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

Referenced by exten_state_data_alloc(), and handle_request_subscribe().

{
 struct ast_exten *e;

 if (!(e = ast_hint_extension(c, context, exten))) { /* Do we have a hint for this extension ? */
 return -1; /* No hint, return -1 */
 }

 if (e->exten[0] == '_') {
 /* Create this hint on-the-fly */
 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);
}

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

References ast_context_find(), ast_context_ignorepats_count(), ast_context_ignorepats_get(), ast_extension_match(), ast_get_ignorepat_name(), ast_rdlock_contexts(), and ast_unlock_contexts().

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

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

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 serach within
exten	extension to check
priority	priority of extension path
callerid	callerid of extension being searched for

Note

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

Returns

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

Definition at line 4199 of file pbx.c.

References E_MATCHMORE, NULL, and pbx_extension_helper().

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

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

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

References __ast_internal_context_destroy(), ao2_callback, ao2_container_count(), ao2_find, ao2_iterator_destroy(), AO2_ITERATOR_DONTLOCK, ao2_iterator_init(), ao2_iterator_next, ao2_link, ao2_lock, ao2_ref, ao2_unlock, ast_exten::app, ast_add_extension_nolock(), ast_calloc, ast_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_exten::next, ast_context::next, NULL, OBJ_UNLINK, ast_exten::parent, pbx_find_extension(), PRIORITY_HINT, ast_exten::registrar, pbx_find_info::stacklen, and tmp().

{
 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
 * encumberd by so many locks.
 */
 AST_LIST_INSERT_HEAD(&hints_removed, saved_hint, list);
 } else {
 ao2_lock(hint);
 while ((thiscb = AST_LIST_REMOVE_HEAD(&saved_hint->callbacks, entry))) {
 ao2_link(hint->callbacks, thiscb);
 /* Ref that we added when putting into saved_hint->callbacks */
 ao2_ref(thiscb, -1);
 }
 hint->laststate = saved_hint->laststate;
 hint->last_presence_state = saved_hint->last_presence_state;
 hint->last_presence_subtype = saved_hint->last_presence_subtype;
 hint->last_presence_message = saved_hint->last_presence_message;
 ao2_unlock(hint);
 ao2_ref(hint, -1);
 /*
 * The free of saved_hint->last_presence_subtype and
 * saved_hint->last_presence_message is not necessary here.
 */
 ast_free(saved_hint);
 }
 }

 /* 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(3,"Time to scan old dialplan and merge leftovers back into the new: %8.6f sec\n", ft);

 ft = ast_tvdiff_us(endlocktime, writelocktime);
 ft /= 1000000.0;
 ast_verb(3,"Time to restore hints and swap in new dialplan: %8.6f sec\n", ft);

 ft = ast_tvdiff_us(enddeltime, endlocktime);
 ft /= 1000000.0;
 ast_verb(3,"Time to delete the old dialplan: %8.6f sec\n", ft);

 ft = ast_tvdiff_us(enddeltime, begintime);
 ft /= 1000000.0;
 ast_verb(3,"Total time merge_contexts_delete: %8.6f sec\n", ft);
 ast_verb(3, "%s successfully loaded %d contexts (enable debug for details).\n", registrar, ctx_count);
}

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

References pbx_parseable_goto().

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

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

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.

Returns

Nothing

Definition at line 4209 of file pbx.c.

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, NULL, and S_COR.

Referenced by __ast_pbx_run(), and ast_bridge_setup_after_goto().

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

ast_pbx_init()

int ast_pbx_init

(

void

)

Provided by pbx.c

Definition at line 8982 of file pbx.c.

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(), HASH_EXTENHINT_SIZE, hint_cmp(), hint_hash(), hintdevice_cmp_multiple(), hintdevice_hash_cb(), NULL, pbx_shutdown(), print_autohint_key(), print_hintdevices_key(), print_hints_key(), print_statecbs_key(), STASIS_MESSAGE_TYPE_INIT, and statecbs_cmp().

Referenced by asterisk_daemon().

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

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

References ast_pbx_outgoing_app_predial(), and NULL.

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

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

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

References ast_strlen_zero, NULL, and pbx_outgoing_attempt().

Referenced by ast_pbx_outgoing_app(), and originate_exec().

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

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 exists then run a channel named OutgoingSpoolFailed at failed .
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 7951 of file pbx.c.

References ast_pbx_outgoing_exten_predial(), and NULL.

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

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

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

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, LOG_ERROR, NULL, pbx_builtin_setvar_helper(), and pbx_outgoing_attempt().

Referenced by ast_pbx_outgoing_exten(), and originate_exec().

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

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

References ast_pbx_run_args(), 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(), mgcp_ss(), pbx_outgoing_exec(), skinny_newcall(), and unistim_ss().

{
 return ast_pbx_run_args(c, NULL);
}

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

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

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

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

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

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

Referenced by alsa_new(), ast_async_goto(), ast_iax2_new(), bridge_failed_peer_goto(), console_new(), dahdi_new(), dial_exec_full(), do_monitor_headset(), generic_recall(), handle_request_invite(), handle_response_clip(), handle_response_cmgr(), jingle_action_session_initiate(), local_call(), mgcp_new(), nbs_new(), ooh323_new(), oss_new(), pbx_start_chan(), pbx_start_incoming_request(), phone_new(), skinny_new(), unistim_new(), and wait_for_digits().

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

ast_processed_calls()

int ast_processed_calls

(

void

)

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

Definition at line 4769 of file pbx.c.

References totalcalls.

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

{
 return totalcalls;
}

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

References ast_rwlock_rdlock, and ast_context::lock.

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

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

ast_rdlock_contexts()

int ast_rdlock_contexts

(

void

)

Read locks the context list.

Return values

0	on success
-1	on error

Definition at line 8507 of file pbx.c.

References ast_mutex_lock, and conlock.

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

{
 return ast_mutex_lock(&conlock);
}

ast_remove_hint()

static int ast_remove_hint ( struct ast_exten *  e )

static

Remove hint from extension.

Definition at line 3945 of file pbx.c.

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

Referenced by destroy_exten().

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

 if (!e) {
 return -1;
 }

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

 remove_hintdevice(hint);

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

 publish_hint_remove(hint);

 ao2_ref(hint, -1);

 return 0;
}

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

References E_SPAWN, NULL, and pbx_extension_helper().

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

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

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

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

Referenced by ast_str_retrieve_variable().

{
 struct ast_exten *e = ast_hint_extension(c, context, exten);

 if (!e) {
 return 0;
 }

 if (hint) {
 ast_str_set(hint, hintsize, "%s", ast_get_extension_app(e));
 }
 if (name) {
 const char *tmp = ast_get_extension_app_data(e);
 if (tmp) {
 ast_str_set(name, namesize, "%s", tmp);
 }
 }
 return -1;
}

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

References ast_rwlock_unlock, and ast_context::lock.

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

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

ast_unlock_contexts()

int ast_unlock_contexts

(

void

)

Unlocks contexts.

Return values

0	on success
-1	on failure

Definition at line 8512 of file pbx.c.

References ast_mutex_unlock, and conlock.

Referenced by _macro_exec(), 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_lockmacro(), ast_context_remove_extension_callerid(), ast_context_remove_ignorepat(), ast_context_remove_include(), ast_context_remove_switch(), ast_context_unlockmacro(), ast_hint_extension(), ast_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(), get_extension_data(), 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().

{
 return ast_mutex_unlock(&conlock);
}

ast_walk_context_extensions()

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

Definition at line 8614 of file pbx.c.

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

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

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

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

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

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

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

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

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

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

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

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

ast_walk_contexts()

struct ast_context* ast_walk_contexts

(

struct ast_context *

con

)

Definition at line 8609 of file pbx.c.

References contexts, and ast_context::next.

Referenced by ast_context_find(), complete_show_dialplan_context(), manager_show_dialplan_helper(), show_debug_helper(), show_dialplan_helper(), and unreference_cached_app().

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

ast_walk_extension_priorities()

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

Definition at line 8662 of file pbx.c.

References ast_exten::exten, and ast_exten::peer.

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

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

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

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

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

ast_wrlock_contexts()

int ast_wrlock_contexts

(

void

)

Write locks the context list.

Return values

0	on success
-1	on error

Definition at line 8502 of file pbx.c.

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

{
 return ast_mutex_lock(&conlock);
}

autohint_cmp()

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

static

Definition at line 474 of file pbx.c.

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

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

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

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

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

candidate_exten_advance()

static const char* candidate_exten_advance ( const char *  str )

static

Definition at line 1219 of file pbx.c.

References str.

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

cli_match_char_tree()

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

static

Definition at line 1111 of file pbx.c.

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

Referenced by show_debug_helper().

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

 extenstr[0] = '\0';

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

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

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

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

Referenced by __ast_pbx_run().

{
 int digit;

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

compare_char()

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

static

Definition at line 674 of file pbx.c.

References a, b, and bc.

Referenced by get_pattern_node().

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

 return *ac - *bc;
}

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

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

Referenced by handle_show_hint().

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

 if (pos != 3)
 return NULL;

 wordlen = strlen(word);

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

 return ret;
}

complete_show_dialplan_context()

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

static

Definition at line 5447 of file pbx.c.

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

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

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

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_context::autohints, ast_exten::cidmatch, context_merge_incls_swits_igps_other_registrars(), ast_exten::data, first, ast_exten::label, LOG_ERROR, ast_exten::matchcid, ast_exten::name, ast_context::name, NULL, ast_exten::peer_table, ast_exten::priority, ast_context::refcount, ast_exten::registrar, ast_context::registrar, ast_exten::registrar_file, ast_exten::registrar_line, and ast_context::root_table.

Referenced by ast_merge_contexts_and_delete().

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

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

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

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

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

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

Referenced by context_merge().

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

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

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, ast_autohint::context, ast_context::name, NULL, OBJ_MULTIPLE, OBJ_NODATA, OBJ_UNLINK, ast_context::registrar, and ast_autohint::registrar.

Referenced by ast_merge_contexts_and_delete().

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

create_match_char_tree()

static void create_match_char_tree ( struct ast_context *  con )

static

Definition at line 1756 of file pbx.c.

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

Referenced by pbx_find_extension().

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

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

decrease_call_count()

static void decrease_call_count ( void  )

static

Definition at line 4670 of file pbx.c.

References ast_mutex_lock, ast_mutex_unlock, and maxcalllock.

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

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

destroy_exten()

static void destroy_exten ( struct ast_exten *  e )

static

Definition at line 4678 of file pbx.c.

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

Referenced by __ast_internal_context_destroy(), and ast_context_remove_extension_callerid2().

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

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

destroy_hint()

static void destroy_hint ( void *  obj )

static

Definition at line 3907 of file pbx.c.

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

Referenced by ast_add_hint().

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

destroy_pattern_tree()

static void destroy_pattern_tree ( struct match_char *  pattern_tree )

static

Definition at line 1779 of file pbx.c.

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

Referenced by __ast_internal_context_destroy().

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

destroy_state_cb()

static void destroy_state_cb ( void *  doomed )

static

Definition at line 3716 of file pbx.c.

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

Referenced by extension_state_add_destroy().

{
 struct ast_state_cb *state_cb = doomed;

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

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.

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

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

device_state_info_dt()

static void device_state_info_dt ( void *  obj )

static

Definition at line 3069 of file pbx.c.

References ao2_cleanup, ast_device_state_info::causing_channel, and sip_to_pjsip::info().

Referenced by ast_extension_state3().

{
 struct ast_device_state_info *info = obj;

 ao2_cleanup(info->causing_channel);
}

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.

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

Referenced by device_state_cb(), and handle_hint_change_message_type().

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

exception_store_free()

static void exception_store_free ( void *  data )

static

Definition at line 2783 of file pbx.c.

References ast_free, ast_string_field_free_memory, and ast_exten::data.

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

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.

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

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

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

ext_cmp()

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

static

Definition at line 2126 of file pbx.c.

References ext_cmp_exten(), and ext_cmp_pattern().

Referenced by ast_add_extension2_lockopt(), and ast_extension_cmp().

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

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

ext_cmp_exten()

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

static

Definition at line 1876 of file pbx.c.

Referenced by _extension_match_core(), and ext_cmp().

{
 int cmp;

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

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

ext_cmp_exten_partial()

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

static

Definition at line 1833 of file pbx.c.

Referenced by _extension_match_core().

{
 int cmp;

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

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

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

ext_cmp_exten_strlen()

static int ext_cmp_exten_strlen ( const char *  str )

static

Definition at line 1803 of file pbx.c.

References len(), and str.

Referenced by _extension_match_core().

{
 int len;

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

ext_cmp_pattern()

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

static

Definition at line 2078 of file pbx.c.

References ARRAY_LEN, and ext_cmp_pattern_pos().

Referenced by _extension_match_core(), and ext_cmp().

{
 int cmp;
 int left_pos;
 int right_pos;

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

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

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

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

Referenced by ext_cmp_pattern().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ext_fluff_count()

static int ext_fluff_count ( const char *  exten )

static

Definition at line 2148 of file pbx.c.

Referenced by ast_add_extension2_lockopt().

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

ext_strncpy()

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

static

Definition at line 7068 of file pbx.c.

Referenced by ast_add_extension2_lockopt(), and ast_context_remove_extension_callerid2().

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

extension_match_core()

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

static

Definition at line 2400 of file pbx.c.

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

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

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

 /* If this is a pattern, dynamically create a new extension for this
 * particular match. Note that this will only happen once for each
 * individual extension, because the pattern will no longer match first.
 */
 if (e->exten[0] == '_') {
 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;
}

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

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

Referenced by ast_add_extension_nolock(), and pbx_find_extension().

{
 struct fake_context item;

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

 return ast_hashtab_lookup(contexts_table, &item);
}

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

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

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

{
 struct ast_context *c;
 struct fake_context item;

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

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

 return c;
}

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

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

Referenced by ast_extension_state_del().

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

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

 return 0;
}

get_canmatch_exten()

static struct ast_exten * get_canmatch_exten ( struct match_char *  node )

static

Definition at line 1141 of file pbx.c.

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

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

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

get_device_state_causing_channels()

static void get_device_state_causing_channels ( struct ao2_container *  c )

static

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

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

Definition at line 3296 of file pbx.c.

References ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_channel_creationtime(), ast_channel_iterator_by_name_new(), ast_channel_iterator_destroy(), ast_channel_iterator_next(), ast_channel_lock, AST_CHANNEL_NAME, ast_channel_ref, ast_channel_unlock, ast_channel_unref, AST_DEVICE_BUSY, AST_DEVICE_INUSE, AST_DEVICE_INVALID, AST_DEVICE_NOT_INUSE, AST_DEVICE_ONHOLD, AST_DEVICE_RINGING, AST_DEVICE_RINGINUSE, AST_DEVICE_TOTAL, AST_DEVICE_UNAVAILABLE, AST_DEVICE_UNKNOWN, AST_STATE_BUSY, AST_STATE_RINGING, AST_STATE_UP, ast_tvcmp(), ast_device_state_info::causing_channel, ast_device_state_info::device_name, ast_device_state_info::device_state, sip_to_pjsip::info(), and match().

Referenced by ast_extension_state_extended(), and device_state_notify_callbacks().

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

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

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

Referenced by add_exten_to_pattern_tree().

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

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

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

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

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

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

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

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

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

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

#undef INC_DST_OVERFLOW_CHECK
}

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

References ast_cli_args::argc, ast_cli_args::argv, 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(), dialplan_counters::context_existence, ast_exten::exten, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, NULL, ast_cli_args::pos, show_debug_helper(), strsep(), dialplan_counters::total_context, ast_cli_entry::usage, and ast_cli_args::word.

{
 char *exten = NULL, *context = NULL;
 /* Variables used for different counters */
 struct dialplan_counters counters;
 const char *incstack[AST_PBX_MAX_STACK];

 switch (cmd) {
 case CLI_INIT:
 e->command = "dialplan debug";
 e->usage =
 "Usage: dialplan debug [context]\n"
 " Show dialplan context Trie(s). Usually only useful to folks debugging the deep internals of the fast pattern matcher\n";
 return NULL;
 case CLI_GENERATE:
 return complete_show_dialplan_context(a->line, a->word, a->pos, a->n);
 }

 memset(&counters, 0, sizeof(counters));

 if (a->argc != 2 && a->argc != 3)
 return CLI_SHOWUSAGE;

 /* we obtain [exten@]context? if yes, split them ... */
 /* note: we ignore the exten totally here .... */
 if (a->argc == 3) {
 if (strchr(a->argv[2], '@')) { /* split into exten & context */
 context = ast_strdupa(a->argv[2]);
 exten = strsep(&context, "@");
 /* change empty strings to NULL */
 if (ast_strlen_zero(exten))
 exten = NULL;
 } else { /* no '@' char, only context given */
 context = ast_strdupa(a->argv[2]);
 }
 if (ast_strlen_zero(context))
 context = NULL;
 }
 /* else Show complete dial plan, context and exten are NULL */
 show_debug_helper(a->fd, context, exten, &counters, NULL, 0, incstack);

 /* check for input failure and throw some error messages */
 if (context && !counters.context_existence) {
 ast_cli(a->fd, "There is no existence of '%s' context\n", context);
 return CLI_FAILURE;
 }


 ast_cli(a->fd,"-= %d %s. =-\n",
 counters.total_context, counters.total_context == 1 ? "context" : "contexts");

 /* everything ok */
 return CLI_SUCCESS;
}

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.

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

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

handle_set_extenpatternmatchnew()

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

static

Definition at line 6105 of file pbx.c.

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

{
 int oldval = 0;

 switch (cmd) {
 case CLI_INIT:
 e->command = "dialplan set extenpatternmatchnew true";
 e->usage =
 "Usage: dialplan set extenpatternmatchnew true|false\n"
 " Use the NEW extension pattern matching algorithm, true or false.\n";
 return NULL;
 case CLI_GENERATE:
 return NULL;
 }

 if (a->argc != 4)
 return CLI_SHOWUSAGE;

 oldval = pbx_set_extenpatternmatchnew(1);

 if (oldval)
 ast_cli(a->fd, "\n -- Still using the NEW pattern match algorithm for extension names in the dialplan.\n");
 else
 ast_cli(a->fd, "\n -- Switched to using the NEW pattern match algorithm for extension names in the dialplan.\n");

 return CLI_SUCCESS;
}

handle_show_device2extenstate()

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

static

Definition at line 6076 of file pbx.c.

References ast_cli(), AST_DEVICE_TOTAL, ast_devstate_aggregate_add(), ast_devstate_aggregate_init(), ast_devstate_aggregate_result(), ast_devstate_str(), ast_devstate_to_extenstate(), ast_extension_state2str(), CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, ast_exten::exten, ast_cli_args::fd, NULL, and ast_cli_entry::usage.

{
 struct ast_devstate_aggregate agg;
 int i, j, exten, combined;

 switch (cmd) {
 case CLI_INIT:
 e->command = "core show device2extenstate";
 e->usage =
 "Usage: core show device2extenstate\n"
 " Lists device state to extension state combinations.\n";
 case CLI_GENERATE:
 return NULL;
 }
 for (i = 0; i < AST_DEVICE_TOTAL; i++) {
 for (j = 0; j < AST_DEVICE_TOTAL; j++) {
 ast_devstate_aggregate_init(&agg);
 ast_devstate_aggregate_add(&agg, i);
 ast_devstate_aggregate_add(&agg, j);
 combined = ast_devstate_aggregate_result(&agg);
 exten = ast_devstate_to_extenstate(combined);
 ast_cli(a->fd, "\n Exten:%14s CombinedDevice:%12s Dev1:%12s Dev2:%12s", ast_extension_state2str(exten), ast_devstate_str(combined), ast_devstate_str(j), ast_devstate_str(i));
 }
 }
 ast_cli(a->fd, "\n");
 return CLI_SUCCESS;
}

handle_show_dialplan()

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

static

Definition at line 5732 of file pbx.c.

References ast_cli_args::argc, ast_cli_args::argv, 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(), dialplan_counters::context_existence, ast_exten::exten, dialplan_counters::extension_existence, ast_cli_args::fd, ast_cli_args::line, ast_cli_args::n, NULL, ast_cli_args::pos, show_dialplan_helper(), strsep(), dialplan_counters::total_context, dialplan_counters::total_exten, dialplan_counters::total_prio, ast_cli_entry::usage, and ast_cli_args::word.

{
 char *exten = NULL, *context = NULL;
 /* Variables used for different counters */
 struct dialplan_counters counters;
 const char *incstack[AST_PBX_MAX_STACK];

 switch (cmd) {
 case CLI_INIT:
 e->command = "dialplan show";
 e->usage =
 "Usage: dialplan show [[exten@]context]\n"
 " Show dialplan\n";
 return NULL;
 case CLI_GENERATE:
 return complete_show_dialplan_context(a->line, a->word, a->pos, a->n);
 }

 memset(&counters, 0, sizeof(counters));

 if (a->argc != 2 && a->argc != 3)
 return CLI_SHOWUSAGE;

 /* we obtain [exten@]context? if yes, split them ... */
 if (a->argc == 3) {
 if (strchr(a->argv[2], '@')) { /* split into exten & context */
 context = ast_strdupa(a->argv[2]);
 exten = strsep(&context, "@");
 /* change empty strings to NULL */
 if (ast_strlen_zero(exten))
 exten = NULL;
 } else { /* no '@' char, only context given */
 context = ast_strdupa(a->argv[2]);
 }
 if (ast_strlen_zero(context))
 context = NULL;
 }
 /* else Show complete dial plan, context and exten are NULL */
 show_dialplan_helper(a->fd, context, exten, &counters, NULL, 0, incstack);

 /* check for input failure and throw some error messages */
 if (context && !counters.context_existence) {
 ast_cli(a->fd, "There is no existence of '%s' context\n", context);
 return CLI_FAILURE;
 }

 if (exten && !counters.extension_existence) {
 if (context)
 ast_cli(a->fd, "There is no existence of %s@%s extension\n",
 exten, context);
 else
 ast_cli(a->fd,
 "There is no existence of '%s' extension in all contexts\n",
 exten);
 return CLI_FAILURE;
 }

 ast_cli(a->fd,"-= %d %s (%d %s) in %d %s. =-\n",
 counters.total_exten, counters.total_exten == 1 ? "extension" : "extensions",
 counters.total_prio, counters.total_prio == 1 ? "priority" : "priorities",
 counters.total_context, counters.total_context == 1 ? "context" : "contexts");

 /* everything ok */
 return CLI_SUCCESS;
}

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

References a, ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_cli_args::argc, ast_cli_args::argv, ast_cli(), ast_extension_state2str(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), ast_log, ast_malloc, 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_cli_args::fd, ast_hint::last_presence_state, ast_hint::laststate, ast_cli_args::line, LOG_ERROR, LOG_WARNING, ast_cli_args::n, NULL, ast_cli_args::pos, ast_cli_entry::usage, and ast_cli_args::word.

{
 struct ast_hint *hint;
 int watchers;
 int num = 0, extenlen;
 struct ao2_iterator i;
 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, "%-20.20s: %-20.20s 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;
}

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

References ao2_container_count(), ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_cli(), ast_extension_state2str(), ast_get_context_name(), ast_get_extension_app(), ast_get_extension_context(), ast_get_extension_name(), AST_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_cli_args::fd, ast_hint::last_presence_state, ast_hint::laststate, NULL, and ast_cli_entry::usage.

{
 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, "%-20.20s: %-20.20s 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;
}

handle_unset_extenpatternmatchnew()

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

static

Definition at line 6133 of file pbx.c.

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

{
 int oldval = 0;

 switch (cmd) {
 case CLI_INIT:
 e->command = "dialplan set extenpatternmatchnew false";
 e->usage =
 "Usage: dialplan set extenpatternmatchnew true|false\n"
 " Use the NEW extension pattern matching algorithm, true or false.\n";
 return NULL;
 case CLI_GENERATE:
 return NULL;
 }

 if (a->argc != 4)
 return CLI_SHOWUSAGE;

 oldval = pbx_set_extenpatternmatchnew(0);

 if (!oldval)
 ast_cli(a->fd, "\n -- Still using the OLD pattern match algorithm for extension names in the dialplan.\n");
 else
 ast_cli(a->fd, "\n -- Switched to using the OLD pattern match algorithm for extension names in the dialplan.\n");

 return CLI_SUCCESS;
}

hashtab_compare_exten_labels()

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

static

Definition at line 728 of file pbx.c.

References bc, ast_exten::label, and S_OR.

Referenced by ast_add_extension2_lockopt().

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

hashtab_compare_exten_numbers()

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

static

Definition at line 721 of file pbx.c.

References bc, and ast_exten::priority.

Referenced by ast_add_extension2_lockopt().

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

hashtab_compare_extens()

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

static

Definition at line 693 of file pbx.c.

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

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

hashtab_hash_extens()

static unsigned int hashtab_hash_extens ( const void *  obj )

static

Definition at line 741 of file pbx.c.

References AST_EXT_MATCHCID_ON, ast_hashtab_hash_string(), ast_exten::cidmatch, ast_exten::exten, and ast_exten::matchcid.

Referenced by ast_add_extension2_lockopt().

{
 const struct ast_exten *ac = obj;
 unsigned int x = ast_hashtab_hash_string(ac->exten);
 unsigned int y = 0;
 if (ac->matchcid == AST_EXT_MATCHCID_ON)
 y = ast_hashtab_hash_string(ac->cidmatch);
 return x+y;
}

hashtab_hash_labels()

static unsigned int hashtab_hash_labels ( const void *  obj )

static

Definition at line 757 of file pbx.c.

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

Referenced by ast_add_extension2_lockopt().

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

hashtab_hash_priority()

static unsigned int hashtab_hash_priority ( const void *  obj )

static

Definition at line 751 of file pbx.c.

References ast_hashtab_hash_int(), and ast_exten::priority.

Referenced by ast_add_extension2_lockopt().

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

hint_cmp()

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

static

Definition at line 8889 of file pbx.c.

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

Referenced by ast_pbx_init().

{
 const struct ast_hint *hint = obj;
 const struct ast_exten *exten = arg;

 return (hint->exten == exten) ? CMP_MATCH | CMP_STOP : 0;
}

hint_hash()

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

static

Definition at line 8869 of file pbx.c.

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

Referenced by ast_pbx_init().

{
 const struct ast_hint *hint = obj;
 const char *exten_name;
 int res;

 exten_name = ast_get_extension_name(hint->exten);
 if (ast_strlen_zero(exten_name)) {
 /*
 * If the exten or extension name isn't set, return 0 so that
 * the ao2_find() search will start in the first bucket.
 */
 res = 0;
 } else {
 res = ast_str_case_hash(exten_name);
 }

 return res;
}

hint_id_cmp()

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

static

Definition at line 3891 of file pbx.c.

References CMP_MATCH, CMP_STOP, and ast_state_cb::id.

Referenced by ast_add_hint().

{
 const struct ast_state_cb *cb = obj;
 int *id = arg;

 return (cb->id == *id) ? CMP_MATCH | CMP_STOP : 0;
}

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

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

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

hintdevice_destroy()

static void hintdevice_destroy ( void *  obj )

static

Definition at line 540 of file pbx.c.

References ao2_ref, ast_hintdevice::hint, and NULL.

Referenced by add_hintdevice().

{
 struct ast_hintdevice *doomed = obj;

 if (doomed->hint) {
 ao2_ref(doomed->hint, -1);
 doomed->hint = NULL;
 }
}

hintdevice_hash_cb()

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

static

Note

Using the device for hash

Definition at line 395 of file pbx.c.

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

Referenced by ast_pbx_init().

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

hintdevice_remove_cb()

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

static

Definition at line 504 of file pbx.c.

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

Referenced by remove_hintdevice().

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

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

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

Referenced by ast_pbx_run_args(), and ast_pbx_start().

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

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

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

Referenced by add_pattern_node().

{
 struct match_char *curr, *lcurr;

 /* insert node into the tree at "current", so the alt_char list from current is
 sorted in increasing value as you go to the leaves */
 if (!(*parent_ptr)) {
 *parent_ptr = node;
 return;
 }

 if ((*parent_ptr)->specificity > node->specificity) {
 /* insert at head */
 node->alt_char = (*parent_ptr);
 *parent_ptr = node;
 return;
 }

 lcurr = *parent_ptr;
 for (curr = (*parent_ptr)->alt_char; curr; curr = curr->alt_char) {
 if (curr->specificity > node->specificity) {
 node->alt_char = curr;
 lcurr->alt_char = node;
 break;
 }
 lcurr = curr;
 }

 if (!curr) {
 lcurr->alt_char = node;
 }

}

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.

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

Referenced by ast_extension_state(), and ast_extension_state_extended().

{
 struct ast_exten *e;

 if (!(e = ast_hint_extension(c, context, exten))) { /* Do we have a hint for this extension ? */
 return -1; /* No hint, return -1 */
 }

 if (e->exten[0] == '_') {
 /* Create this hint on-the-fly, 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 */
}

load_pbx()

int load_pbx

(

void

)

Provided by pbx.c

Definition at line 8460 of file pbx.c.

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(), EVENT_FLAG_CALL, EVENT_FLAG_CONFIG, EVENT_FLAG_REPORTING, manager_show_dialplan(), NULL, presence_state_cb(), stasis_subscribe, stasis_subscription_accept_message_type(), STASIS_SUBSCRIPTION_FILTER_SELECTIVE, stasis_subscription_set_filter(), and unload_pbx().

Referenced by asterisk_daemon().

{
 int res = 0;

 ast_register_cleanup(unload_pbx);

 /* Initialize the PBX */
 ast_verb(1, "Asterisk PBX Core Initializing\n");

 ast_verb(2, "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;
}

manager_dpsendack()

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

static

Send ack once.

Definition at line 5855 of file pbx.c.

References astman_send_listack().

Referenced by manager_show_dialplan(), and manager_show_dialplan_helper().

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

manager_show_dialplan()

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

static

Manager listing of dial plan.

Definition at line 6019 of file pbx.c.

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(), context, dialplan_counters::context_existence, ast_exten::exten, 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().

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

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

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, dialplan_counters::context_existence, dialplan_counters::extension_existence, LOG_WARNING, manager_dpsendack(), 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().

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

matchcid()

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

static

Definition at line 2473 of file pbx.c.

References ast_extension_match(), and ast_strlen_zero.

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

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

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_MATCHER_CHK_MATCH, NEW_MATCHER_RECURSE, match_char::next_char, match_char::specificity, str, update_scoreboard(), and match_char::x.

Referenced by pbx_find_extension().

{
 struct match_char *p; /* note minimal stack storage requirements */
 struct ast_exten pattern = { .label = label };
#ifdef DEBUG_THIS
 if (tree)
 ast_log(LOG_NOTICE,"new_find_extension called with %s on (sub)tree %s action=%s\n", str, tree->x, action2str(action));
 else
 ast_log(LOG_NOTICE,"new_find_extension called with %s on (sub)tree NULL action=%s\n", str, action2str(action));
#endif
 for (p = tree; p; p = p->alt_char) {
 if (p->is_pattern) {
 if (p->x[0] == 'N') {
 if (p->x[1] == 0 && *str >= '2' && *str <= '9' ) {
#define NEW_MATCHER_CHK_MATCH \
 if (p->exten && !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");
}

parse_hint_device()

static char * parse_hint_device ( struct ast_str *  hint_args )

static

Definition at line 3056 of file pbx.c.

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

Referenced by ast_extension_state3(), and remove_hintdevice().

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

parse_hint_presence()

static char* parse_hint_presence ( struct ast_str *  hint_args )

static

Definition at line 3037 of file pbx.c.

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

Referenced by extension_presence_state_helper().

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

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

References ast_strlen_zero.

Referenced by _if_exec(), _macro_exec(), _while_exec(), acf_if(), execif_exec(), gosubif_exec(), macroif_exec(), pbx_builtin_gotoif(), and testtime_write().

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

pbx_destroy()

static void pbx_destroy ( struct ast_pbx *  p )

static

Definition at line 985 of file pbx.c.

References ast_free.

Referenced by __ast_pbx_run().

{
 ast_free(p);
}

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

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

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

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.

References 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, ast_exten::cached_app, COLOR_BRCYAN, COLOR_BRMAGENTA, COLORIZE, COLORIZE_FMT, 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(), 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().

{
 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", label, exten, S_OR(context, ""));
 break;
 default:
 ast_debug(1, "Shouldn't happen!\n");
 }

 return (matching_action) ? 0 : -1;
 }
}

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

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, context, create_match_char_tree(), pbx_find_info::data, E_CANMATCH, E_FINDLABEL, E_MATCHMORE, ast_switch::exists, ast_exten::exten, scoreboard::exten, 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(), ast_exten::matchcid, ast_switch::matchmore, ast_exten::name, ast_context::name, new_find_extension(), scoreboard::node, NULL, ast_context::pattern_tree, pbx_findswitch(), pbx_substitute_variables_helper(), ast_exten::priority, ast_context::root_table, pbx_find_info::stacklen, pbx_find_info::status, STATUS_NO_CONTEXT, STATUS_NO_EXTENSION, STATUS_NO_LABEL, STATUS_NO_PRIORITY, STATUS_SUCCESS, strsep(), switch_data, pbx_find_info::swo, tmp(), scoreboard::total_length, scoreboard::total_specificity, and trie_find_next_match().

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

{
 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 exceeded\n");
 return NULL;
 }

 /* Check first to see if we've already been checked */
 for (x = 0; x < q->stacklen; x++) {
 if (!strcasecmp(q->incstack[x], context))
 return NULL;
 }

 if (bypass) { /* bypass means we only look there */
 tmp = bypass;
 } else { /* look in contexts */
 tmp = find_context(context);
 if (!tmp) {
 return NULL;
 }
 }

 if (q->status < STATUS_NO_EXTENSION)
 q->status = STATUS_NO_EXTENSION;

 /* Do a search for matching extension */

 eroot = NULL;
 score.total_specificity = 0;
 score.exten = 0;
 score.total_length = 0;
 if (!tmp->pattern_tree && tmp->root_table) {
 create_match_char_tree(tmp);
#ifdef NEED_DEBUG
 ast_debug(1, "Tree Created in context %s:\n", context);
 log_match_char_tree(tmp->pattern_tree," ");
#endif
 }
#ifdef NEED_DEBUG
 ast_log(LOG_NOTICE, "The Trie we are searching in:\n");
 log_match_char_tree(tmp->pattern_tree, ":: ");
#endif

 do {
 if (!ast_strlen_zero(overrideswitch)) {
 char *osw = ast_strdupa(overrideswitch), *name;
 struct ast_switch *asw;
 ast_switch_f *aswf = NULL;
 char *datap;
 int eval = 0;

 name = strsep(&osw, "/");
 asw = pbx_findswitch(name);

 if (!asw) {
 ast_log(LOG_WARNING, "No such switch '%s'\n", name);
 break;
 }

 if (osw && strchr(osw, '$')) {
 eval = 1;
 }

 if (eval && !(tmpdata = ast_str_thread_get(&switch_data, 512))) {
 ast_log(LOG_WARNING, "Can't evaluate overrideswitch?!\n");
 break;
 } else if (eval) {
 /* Substitute variables now */
 pbx_substitute_variables_helper(chan, osw, ast_str_buffer(tmpdata), ast_str_size(tmpdata));
 datap = ast_str_buffer(tmpdata);
 } else {
 datap = osw;
 }

 /* equivalent of extension_match_core() at the switch level */
 if (action == E_CANMATCH)
 aswf = asw->canmatch;
 else if (action == E_MATCHMORE)
 aswf = asw->matchmore;
 else /* action == E_MATCH */
 aswf = asw->exists;
 if (!aswf) {
 res = 0;
 } else {
 if (chan) {
 ast_autoservice_start(chan);
 }
 res = aswf(chan, context, exten, priority, callerid, datap);
 if (chan) {
 ast_autoservice_stop(chan);
 }
 }
 if (res) { /* Got a match */
 q->swo = asw;
 q->data = datap;
 q->foundcontext = context;
 /* XXX keep status = STATUS_NO_CONTEXT ? */
 return NULL;
 }
 }
 } while (0);

 if (extenpatternmatchnew) {
 new_find_extension(exten, &score, tmp->pattern_tree, 0, 0, callerid, label, action);
 eroot = score.exten;

 if (score.last_char == '!' && action == E_MATCHMORE) {
 /* We match an extension ending in '!'.
 * The decision in this case is final and is NULL (no match).
 */
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE,"Returning MATCHMORE NULL with exclamation point.\n");
#endif
 return NULL;
 }

 if (!eroot && (action == E_CANMATCH || action == E_MATCHMORE) && score.canmatch_exten) {
 q->status = STATUS_SUCCESS;
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE,"Returning CANMATCH exten %s\n", score.canmatch_exten->exten);
#endif
 return score.canmatch_exten;
 }

 if ((action == E_MATCHMORE || action == E_CANMATCH) && eroot) {
 if (score.node) {
 struct ast_exten *z = trie_find_next_match(score.node);
 if (z) {
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE,"Returning CANMATCH/MATCHMORE next_match exten %s\n", z->exten);
#endif
 } else {
 if (score.canmatch_exten) {
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE,"Returning CANMATCH/MATCHMORE canmatchmatch exten %s(%p)\n", score.canmatch_exten->exten, score.canmatch_exten);
#endif
 return score.canmatch_exten;
 } else {
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE,"Returning CANMATCH/MATCHMORE next_match exten NULL\n");
#endif
 }
 }
 return z;
 }
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE, "Returning CANMATCH/MATCHMORE NULL (no next_match)\n");
#endif
 return NULL; /* according to the code, complete matches are null matches in MATCHMORE mode */
 }

 if (eroot) {
 /* found entry, now look for the right priority */
 if (q->status < STATUS_NO_PRIORITY)
 q->status = STATUS_NO_PRIORITY;
 e = NULL;
 if (action == E_FINDLABEL && label ) {
 if (q->status < STATUS_NO_LABEL)
 q->status = STATUS_NO_LABEL;
 e = ast_hashtab_lookup(eroot->peer_label_table, &pattern);
 } else {
 e = ast_hashtab_lookup(eroot->peer_table, &pattern);
 }
 if (e) { /* found a valid match */
 q->status = STATUS_SUCCESS;
 q->foundcontext = context;
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE,"Returning complete match of exten %s\n", e->exten);
#endif
 return e;
 }
 }
 } else { /* the old/current default exten pattern match algorithm */

 /* scan the list trying to match extension and CID */
 eroot = NULL;
 while ( (eroot = ast_walk_context_extensions(tmp, eroot)) ) {
 int match = extension_match_core(eroot->exten, exten, action);
 /* 0 on fail, 1 on match, 2 on earlymatch */

 if (!match || (eroot->matchcid && !matchcid(eroot->cidmatch, callerid)))
 continue; /* keep trying */
 if (match == 2 && action == E_MATCHMORE) {
 /* We match an extension ending in '!'.
 * The decision in this case is final and is NULL (no match).
 */
 return NULL;
 }
 /* found entry, now look for the right priority */
 if (q->status < STATUS_NO_PRIORITY)
 q->status = STATUS_NO_PRIORITY;
 e = NULL;
 if (action == E_FINDLABEL && label ) {
 if (q->status < STATUS_NO_LABEL)
 q->status = STATUS_NO_LABEL;
 e = ast_hashtab_lookup(eroot->peer_label_table, &pattern);
 } else {
 e = ast_hashtab_lookup(eroot->peer_table, &pattern);
 }
 if (e) { /* found a valid match */
 q->status = STATUS_SUCCESS;
 q->foundcontext = context;
 return e;
 }
 }
 }

 /* Check alternative switches */
 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;
 }
 }
 q->incstack[q->stacklen++] = tmp->name; /* 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;
}

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

References ao2_alloc, ao2_cleanup, ao2_lock, ao2_object_get_lockaddr(), ao2_ref, ao2_unlock, 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, outgoing::context, ast_channel::dialed, outgoing::exten, ast_party_connected_line::id, LOG_WARNING, ast_exten::name, ast_party_id::name, NULL, ast_party_id::number, pbx_dial_reason(), pbx_outgoing_destroy(), pbx_outgoing_exec(), pbx_outgoing_state_callback(), ast_party_name::presentation, ast_party_number::presentation, outgoing::priority, ast_exten::priority, RAII_VAR, S_COR, ast_party_name::str, ast_party_number::str, thread, tmp(), ast_party_name::valid, and ast_party_number::valid.

Referenced by ast_pbx_outgoing_app_predial(), and ast_pbx_outgoing_exten_predial().

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

pbx_outgoing_destroy()

static void pbx_outgoing_destroy ( void *  obj )

static

Destructor for outgoing structure.

Definition at line 7613 of file pbx.c.

References pbx_outgoing::appdata, ast_cond_destroy, ast_dial_destroy(), ast_free, pbx_outgoing::cond, and pbx_outgoing::dial.

Referenced by pbx_outgoing_attempt().

{
 struct pbx_outgoing *outgoing = obj;

 if (outgoing->dial) {
 ast_dial_destroy(outgoing->dial);
 }

 ast_cond_destroy(&outgoing->cond);

 ast_free(outgoing->appdata);
}

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

References ao2_cleanup, ao2_lock, ao2_unlock, outgoing::app, ast_exten::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().

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

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

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

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

pbx_parseable_goto()

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

static

Definition at line 8803 of file pbx.c.

References ast_async_goto(), ast_channel_caller(), ast_channel_context(), ast_channel_exten(), ast_channel_priority(), ast_explicit_goto(), ast_findlabel_extension(), ast_log, ast_strdupa, ast_strlen_zero, context, ast_exten::exten, LOG_WARNING, NULL, S_COR, and strsep().

Referenced by ast_async_parseable_goto(), and ast_parseable_goto().

{
 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 (!exten) { /* Only a priority in this one */
 pri = context;
 exten = NULL;
 context = NULL;
 } else if (!pri) { /* Only an extension and priority in this one */
 pri = exten;
 exten = context;
 context = NULL;
 }
 if (*pri == '+') {
 mode = 1;
 pri++;
 } else if (*pri == '-') {
 mode = -1;
 pri++;
 }
 if (sscanf(pri, "%30d%1s", &ipri, rest) != 1) {
 ipri = ast_findlabel_extension(chan, context ? context : ast_channel_context(chan),
 exten ? exten : ast_channel_exten(chan), pri,
 S_COR(ast_channel_caller(chan)->id.number.valid, ast_channel_caller(chan)->id.number.str, NULL));
 if (ipri < 1) {
 ast_log(LOG_WARNING, "Priority '%s' must be a number > 0, or valid label\n", pri);
 return -1;
 } else
 mode = 0;
 }
 /* At this point we have a priority and maybe an extension and a context */

 if (mode)
 ipri = ast_channel_priority(chan) + (ipri * mode);

 if (async)
 ast_async_goto(chan, context, exten, ipri);
 else
 ast_explicit_goto(chan, context, exten, ipri);

 return 0;

}

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

References autofallthrough.

Referenced by pbx_load_module().

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

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

References extenpatternmatchnew.

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

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

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

References ast_free, ast_strdup, ast_strlen_zero, and NULL.

Referenced by pbx_load_module().

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

pbx_shutdown()

static void pbx_shutdown ( void  )

static

Definition at line 8909 of file pbx.c.

References ao2_container_unregister(), ao2_ref, ast_hashtab_destroy(), NULL, and STASIS_MESSAGE_TYPE_CLEANUP.

Referenced by ast_pbx_init().

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

pbx_thread()

static void* pbx_thread ( void *  data )

static

Definition at line 4692 of file pbx.c.

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

Referenced by ast_pbx_start().

{
 /* Oh joyeous kernel, we're a new thread, with nothing to do but
 answer this channel and get it going.
 */
 /* NOTE:
 The launcher of this function _MUST_ increment 'countcalls'
 before invoking the function; it will be decremented when the
 PBX has finished running on the channel
 */
 struct ast_channel *c = data;

 __ast_pbx_run(c, NULL);
 decrease_call_count();

 pthread_exit(NULL);

 return NULL;
}

presence_state_cb()

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

static

Definition at line 8333 of file pbx.c.

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(), NULL, OBJ_MULTIPLE, OBJ_POINTER, presence_state_notify_callbacks(), stasis_message_data(), and stasis_message_type().

Referenced by load_pbx().

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

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.

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, and ast_presence_state_message::state.

Referenced by handle_hint_change_message_type(), and presence_state_cb().

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

print_autohint_key()

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

static

Definition at line 8962 of file pbx.c.

References ast_autohint::context.

Referenced by ast_pbx_init().

{
 struct ast_autohint *autohint = v_obj;

 if (!autohint) {
 return;
 }
 prnt(where, "%s", autohint->context);
}

print_ext()

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

static

helper function to print an extension

Definition at line 5487 of file pbx.c.

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

Referenced by show_dialplan_helper().

{
 int prio = ast_get_extension_priority(e);
 if (prio == PRIORITY_HINT) {
 snprintf(buf, buflen, "hint: %s",
 ast_get_extension_app(e));
 } else {
 snprintf(buf, buflen, "%d. %s(%s)",
 prio, ast_get_extension_app(e),
 (!ast_strlen_zero(ast_get_extension_app_data(e)) ? (char *)ast_get_extension_app_data(e) : ""));
 }
}

print_hintdevices_key()

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

static

Definition at line 8950 of file pbx.c.

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

Referenced by ast_pbx_init().

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

print_hints_key()

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

static

Definition at line 8939 of file pbx.c.

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

Referenced by ast_pbx_init().

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

print_statecbs_key()

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

static

Definition at line 8972 of file pbx.c.

References ast_state_cb::id.

Referenced by ast_pbx_init().

{
 struct ast_state_cb *state_cb = v_obj;

 if (!state_cb) {
 return;
 }
 prnt(where, "%d", state_cb->id);
}

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

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

Referenced by ast_change_hint().

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

publish_hint_remove()

static int publish_hint_remove ( struct ast_hint *  hint )

static

Publish a hint removed event.

Definition at line 3924 of file pbx.c.

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

Referenced by ast_remove_hint().

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

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.

References ast_calloc_with_stringfields, ast_channel_context(), ast_channel_datastore_add(), ast_channel_datastore_find(), ast_channel_exten(), ast_channel_priority(), ast_datastore_alloc, ast_datastore_free(), ast_string_field_set, ast_datastore::data, ast_exten::exten, NULL, pbx_exception::priority, and set_ext_pri().

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

{
 struct ast_datastore *ds = ast_channel_datastore_find(chan, &exception_store_info, NULL);
 struct pbx_exception *exception = NULL;

 if (!ds) {
 ds = ast_datastore_alloc(&exception_store_info, NULL);
 if (!ds)
 return -1;
 if (!(exception = ast_calloc_with_stringfields(1, struct pbx_exception, 128))) {
 ast_datastore_free(ds);
 return -1;
 }
 ds->data = exception;
 ast_channel_datastore_add(chan, ds);
 } else
 exception = ds->data;

 ast_string_field_set(exception, reason, reason);
 ast_string_field_set(exception, context, ast_channel_context(chan));
 ast_string_field_set(exception, exten, ast_channel_exten(chan));
 exception->priority = ast_channel_priority(chan);
 set_ext_pri(chan, "e", priority);
 return 0;
}

remove_hintdevice()

static int remove_hintdevice ( struct ast_hint *  hint )

static

Definition at line 517 of file pbx.c.

References ao2_t_callback_data, ast_free, AST_VECTOR_GET, AST_VECTOR_REMOVE_UNORDERED, AST_VECTOR_SIZE, hintdevice_remove_cb(), OBJ_NODATA, OBJ_SEARCH_KEY, OBJ_UNLINK, and parse_hint_device().

Referenced by ast_change_hint(), and ast_remove_hint().

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

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

References ast_channel_exten_set(), ast_channel_lock, ast_channel_priority_set(), and ast_channel_unlock.

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

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

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

References ast_cli(), ast_exists_extension(), ast_get_context_name(), ast_get_context_registrar(), ast_rdlock_context(), ast_rdlock_contexts(), ast_unlock_context(), ast_unlock_contexts(), ast_walk_contexts(), c, cli_match_char_tree(), dialplan_counters::context_existence, ast_context::name, NULL, ast_context::pattern_tree, dialplan_counters::total_context, and dialplan_counters::total_exten.

Referenced by handle_debug_dialplan().

{
 struct ast_context *c = NULL;
 int res = 0, old_total_exten = dpc->total_exten;

 ast_cli(fd,"\n In-mem exten Trie for Fast Extension Pattern Matching:\n\n");

 ast_cli(fd,"\n Explanation: Node Contents Format = <char(s) to match>:<pattern?>:<specif>:[matched extension]\n");
 ast_cli(fd, " Where <char(s) to match> is a set of chars, any one of which should match the current character\n");
 ast_cli(fd, " <pattern?>: Y if this a pattern match (eg. _XZN[5-7]), N otherwise\n");
 ast_cli(fd, " <specif>: an assigned 'exactness' number for this matching char. The lower the number, the more exact the match\n");
 ast_cli(fd, " [matched exten]: If all chars matched to this point, which extension this matches. In form: EXTEN:<exten string>\n");
 ast_cli(fd, " In general, you match a trie node to a string character, from left to right. All possible matching chars\n");
 ast_cli(fd, " are in a string vertically, separated by an unbroken string of '+' characters.\n\n");
 ast_rdlock_contexts();

 /* walk all contexts ... */
 while ( (c = ast_walk_contexts(c)) ) {
 int context_info_printed = 0;

 if (context && strcmp(ast_get_context_name(c), context))
 continue; /* skip this one, name doesn't match */

 dpc->context_existence = 1;

 if (!c->pattern_tree) {
 /* Ignore check_return warning from Coverity for ast_exists_extension below */
 ast_exists_extension(NULL, c->name, "s", 1, ""); /* do this to force the trie to built, if it is not already */
 }

 ast_rdlock_context(c);

 dpc->total_context++;
 ast_cli(fd, "[ Context '%s' created by '%s' ]\n",
 ast_get_context_name(c), ast_get_context_registrar(c));
 context_info_printed = 1;

 if (c->pattern_tree)
 {
 cli_match_char_tree(c->pattern_tree, " ", fd);
 } else {
 ast_cli(fd,"\n No Pattern Trie present. Perhaps the context is empty...or there is trouble...\n\n");
 }

 ast_unlock_context(c);

 /* if we print something in context, make an empty line */
 if (context_info_printed)
 ast_cli(fd, "\n");
 }
 ast_unlock_contexts();

 return (dpc->total_exten == old_total_exten) ? -1 : res;
}

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

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(), ast_context::autohints, buf, buf2, c, ast_exten::cidmatch, dialplan_counters::context_existence, el, dialplan_counters::extension_existence, LOG_WARNING, ast_exten::matchcid, NULL, print_ext(), show_dialplan_helper_extension_output(), dialplan_counters::total_context, dialplan_counters::total_exten, and dialplan_counters::total_prio.

Referenced by handle_show_dialplan().

{
 struct ast_context *c = NULL;
 int res = 0, old_total_exten = dpc->total_exten;

 ast_rdlock_contexts();

 /* walk all contexts ... */
 while ( (c = ast_walk_contexts(c)) ) {
 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;
}

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

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

Referenced by show_dialplan_helper().

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

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

References ast_state_cb::change_cb, CMP_MATCH, and CMP_STOP.

Referenced by ast_pbx_init().

{
 const struct ast_state_cb *state_cb = obj;
 ast_state_cb_type change_cb = arg;

 return (state_cb->change_cb == change_cb) ? CMP_MATCH | CMP_STOP : 0;
}

trie_find_next_match()

static struct ast_exten* trie_find_next_match ( struct match_char *  node )

static

Definition at line 1160 of file pbx.c.

References match_char::alt_char, E_CANMATCH, E_FINDLABEL, E_MATCH, E_MATCHMORE, E_SPAWN, match_char::exten, match_char::next_char, NULL, and match_char::x.

Referenced by pbx_find_extension().

{
 struct match_char *m3;
 struct match_char *m4;
 struct ast_exten *e3;

 if (node && node->x[0] == '.' && !node->x[1]) { /* dot and ! will ALWAYS be next match in a matchmore */
 return node->exten;
 }

 if (node && node->x[0] == '!' && !node->x[1]) {
 return node->exten;
 }

 if (!node || !node->next_char) {
 return NULL;
 }

 m3 = node->next_char;

 if (m3->exten) {
 return m3->exten;
 }
 for (m4 = m3->alt_char; m4; m4 = m4->alt_char) {
 if (m4->exten) {
 return m4->exten;
 }
 }
 for (m4 = m3; m4; m4 = m4->alt_char) {
 e3 = trie_find_next_match(m3);
 if (e3) {
 return e3;
 }
 }

 return NULL;
}

unload_pbx()

static void unload_pbx ( void  )

static

Definition at line 8448 of file pbx.c.

References ARRAY_LEN, ast_cli_unregister_multiple(), ast_custom_function_unregister(), ast_manager_unregister(), and stasis_unsubscribe_and_join().

Referenced by load_pbx().

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

unreference_cached_app()

void unreference_cached_app

(

struct ast_app *

app

)

pbx.c function needed by pbx_app.c

Definition at line 6179 of file pbx.c.

References ast_rdlock_contexts(), ast_unlock_contexts(), ast_walk_context_extensions(), ast_walk_contexts(), ast_walk_extension_priorities(), and NULL.

Referenced by ast_unregister_application().

{
 struct ast_context *context = NULL;
 struct ast_exten *eroot = NULL, *e = NULL;

 ast_rdlock_contexts();
 while ((context = ast_walk_contexts(context))) {
 while ((eroot = ast_walk_context_extensions(context, eroot))) {
 while ((e = ast_walk_extension_priorities(eroot, e))) {
 if (e->cached_app == app)
 e->cached_app = NULL;
 }
 }
 }
 ast_unlock_contexts();

 return;
}

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

References match_char::alt_char, ast_debug, ast_log, ast_str_alloca, ast_str_buffer(), ast_str_set(), match_char::deleted, ast_exten::exten, match_char::exten, scoreboard::exten, match_char::is_pattern, last, scoreboard::last_char, LOG_NOTICE, match_char::next_char, scoreboard::node, prefix, match_char::specificity, scoreboard::total_length, scoreboard::total_specificity, and match_char::x.

Referenced by new_find_extension().

{
 /* if this extension is marked as deleted, then skip this -- if it never shows
 on the scoreboard, it will never be found, nor will halt the traversal. */
 if (deleted)
 return;
 board->total_specificity = spec;
 board->total_length = length;
 board->exten = exten;
 board->last_char = last;
 board->node = node;
#ifdef NEED_DEBUG_HERE
 ast_log(LOG_NOTICE,"Scoreboarding (LONGER) %s, len=%d, score=%d\n", exten->exten, length, spec);
#endif
}

wait_for_hangup()

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

Definition at line 8267 of file pbx.c.

References ast_frfree, ast_read(), ast_safe_sleep(), ast_strlen_zero, and ast_waitfor().

Referenced by indicate_busy(), and indicate_congestion().

{
 int res;
 struct ast_frame *f;
 double waitsec;
 int waittime;

 if (ast_strlen_zero(data) || (sscanf(data, "%30lg", &waitsec) != 1) || (waitsec < 0))
 waitsec = -1;
 if (waitsec > -1) {
 waittime = waitsec * 1000.0;
 ast_safe_sleep(chan, waittime);
 } else do {
 res = ast_waitfor(chan, -1);
 if (res < 0)
 return;
 f = ast_read(chan);
 if (f)
 ast_frfree(f);
 } while(f);
}

Variable Documentation

autofallthrough

int autofallthrough = 1

static

Definition at line 763 of file pbx.c.

Referenced by pbx_set_autofallthrough().

autohints

struct ao2_container* autohints

static

Container for autohint contexts.

Definition at line 380 of file pbx.c.

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

Referenced by ast_context_find_or_create(), ast_merge_contexts_and_delete(), and ast_walk_contexts().

contexts_table

struct ast_hashtab* contexts_table = NULL

static

Definition at line 777 of file pbx.c.

Referenced by ast_merge_contexts_and_delete().

countcalls

int countcalls

static

Definition at line 773 of file pbx.c.

Referenced by ast_active_calls().

device_state_sub

struct stasis_subscription* device_state_sub

static

Subscription for device state change events.

Definition at line 768 of file pbx.c.

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.

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.

extenpatternmatchnew

int extenpatternmatchnew = 0

static

Definition at line 764 of file pbx.c.

Referenced by 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 352 of file pbx.c.

Referenced by add_hintdevice().

hintdevices

struct ao2_container* hintdevices

static

Container for hint devices.

Definition at line 363 of file pbx.c.

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

Referenced by decrease_call_count(), and increase_call_count().

overrideswitch

char* overrideswitch = NULL

static

Definition at line 765 of file pbx.c.

Referenced by handle_cli_dialplan_save().

pbx_cli

struct ast_cli_entry pbx_cli[]

static

Definition at line 6164 of file pbx.c.

presence_state_sub

struct stasis_subscription* presence_state_sub

static

Subscription for presence state change events.

Definition at line 770 of file pbx.c.

statecbs

struct ao2_container* statecbs

static

Definition at line 803 of file pbx.c.

stateid

int stateid = 1

static

Definition at line 792 of file pbx.c.

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

totalcalls

int totalcalls

static

Definition at line 774 of file pbx.c.

Referenced by ast_processed_calls(), and timing_read().