Sat Nov 1 06:29:10 2008

Asterisk developer's documentation

---

pbx.c File Reference

Core PBX routines. More...

#include "asterisk.h"
#include <sys/types.h>
#include <string.h>
#include <unistd.h>
#include <stdlib.h>
#include <stdio.h>
#include <ctype.h>
#include <errno.h>
#include <time.h>
#include <sys/time.h>
#include <limits.h>
#include "asterisk/lock.h"
#include "asterisk/cli.h"
#include "asterisk/pbx.h"
#include "asterisk/channel.h"
#include "asterisk/options.h"
#include "asterisk/logger.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/stringfields.h"
#include "asterisk/threadstorage.h"

Include dependency graph for pbx.c:

Go to the source code of this file.

Data Structures
struct	app_tmp
struct	ast_app
	ast_app: A registered application More...
struct	ast_context
	ast_context: An extension context More...
struct	ast_exten
	ast_exten: An extension The dialplan is saved as a linked list with each context having it's own linked list of extensions - one item per priority. More...
struct	ast_hint
	Structure for dial plan hints. More...
struct	ast_ignorepat
	ast_ignorepat: Ignore patterns in dial plan More...
struct	ast_include
	ast_include: include= support in extensions.conf More...
struct	ast_state_cb
	ast_state_cb: An extension state notify register item More...
struct	ast_sw
	ast_sw: Switch statement in extensions.conf More...
struct	async_stat
struct	cfextension_states
struct	dialplan_counters
struct	pbx_builtin
	Declaration of builtin applications. More...
struct	pbx_find_info
struct	store_hint
Defines
#define	AST_PBX_MAX_STACK   128
#define	BACKGROUND_MATCHEXTEN   (1 << 2)
#define	BACKGROUND_NOANSWER   (1 << 1)
#define	BACKGROUND_PLAYBACK   (1 << 3)
#define	BACKGROUND_SKIP   (1 << 0)
#define	EXT_DATA_SIZE   8192
#define	SAY_STUBS
#define	STATUS_NO_CONTEXT   1
#define	STATUS_NO_EXTENSION   2
#define	STATUS_NO_LABEL   4
#define	STATUS_NO_PRIORITY   3
#define	STATUS_SUCCESS   5
#define	SWITCH_DATA_LENGTH   256
#define	VAR_BUF_SIZE   4096
#define	VAR_HARDTRAN   3
#define	VAR_NORMAL   1
#define	VAR_SOFTTRAN   2
#define	WAITEXTEN_MOH   (1 << 0)
Enumerations
enum	ext_match_t {   E_MATCHMORE = 0x00, E_CANMATCH = 0x01, E_MATCH = 0x02, E_MATCH_MASK = 0x03,   E_SPAWN = 0x12, E_FINDLABEL = 0x22 }
Functions
static struct ast_context *	__ast_context_create (struct ast_context **extcontexts, const char *name, const char *registrar, int existsokay)
void	__ast_context_destroy (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 int	__ast_pbx_run (struct ast_channel *c)
static int	_extension_match_core (const char *pattern, const char *data, enum ext_match_t mode)
static int	add_pri (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. returns 0 on success, -1 on failure
int	ast_active_calls (void)
	Retrieve the number of active calls.
int	ast_add_extension (const char *context, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar)
	Add and extension to an extension context.
int	ast_add_extension2 (struct ast_context *con, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar)
	Add an extension to an extension context, this time with an ast_context *.
static int	ast_add_hint (struct ast_exten *e)
	ast_add_hint: Add hint to hint list, check initial extension state
	AST_APP_OPTIONS (resetcdr_opts,{AST_APP_OPTION('w', AST_CDR_FLAG_POSTED), AST_APP_OPTION('a', AST_CDR_FLAG_LOCKED), AST_APP_OPTION('v', AST_CDR_FLAG_KEEP_VARS),})
	AST_APP_OPTIONS (waitexten_opts,{AST_APP_OPTION_ARG('m', WAITEXTEN_MOH, 0),})
	AST_APP_OPTIONS (background_opts,{AST_APP_OPTION('s', BACKGROUND_SKIP), AST_APP_OPTION('n', BACKGROUND_NOANSWER), AST_APP_OPTION('m', BACKGROUND_MATCHEXTEN), AST_APP_OPTION('p', BACKGROUND_PLAYBACK),})
int	ast_async_goto (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_async_goto_by_name (const char *channame, const char *context, const char *exten, int priority)
int	ast_async_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_build_timing (struct ast_timing *i, const char *info_in)
int	ast_canmatch_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Looks for a valid matching extension.
static int	ast_change_hint (struct ast_exten *oe, struct ast_exten *ne)
	ast_change_hint: Change hint for an extension
int	ast_check_timing (const struct ast_timing *i)
int	ast_context_add_ignorepat (const char *context, const char *value, const char *registrar)
	Add an ignorepat.
int	ast_context_add_ignorepat2 (struct ast_context *con, const char *value, const char *registrar)
int	ast_context_add_include (const char *context, const char *include, const char *registrar)
	Add a context include.
int	ast_context_add_include2 (struct ast_context *con, const char *value, const char *registrar)
	Add a context include.
int	ast_context_add_switch (const char *context, const char *sw, const char *data, int eval, const char *registrar)
	Add a switch.
int	ast_context_add_switch2 (struct ast_context *con, const char *value, const char *data, int eval, const char *registrar)
	Adds a switch (first param is a ast_context).
ast_context *	ast_context_create (struct ast_context **extcontexts, const char *name, const char *registrar)
	Register a new context.
void	ast_context_destroy (struct ast_context *con, const char *registrar)
	Destroy a context (matches the specified context (or ANY context if NULL).
ast_context *	ast_context_find (const char *name)
	Find a context.
ast_context *	ast_context_find_or_create (struct ast_context **extcontexts, const char *name, const char *registrar)
int	ast_context_lockmacro (const char *context)
	locks the macrolock in the given given context
int	ast_context_remove_extension (const char *context, const char *extension, int priority, const char *registrar)
	Simply remove extension from context.
int	ast_context_remove_extension2 (struct ast_context *con, const char *extension, int priority, const char *registrar)
	This functionc locks given context, search for the right extension and fires out all peer in this extensions with given priority. If priority is set to 0, all peers are removed. After that, unlock context and return.
int	ast_context_remove_extension_callerid (const char *context, const char *extension, int priority, const char *callerid, int matchcid, const char *registrar)
int	ast_context_remove_extension_callerid2 (struct ast_context *con, const char *extension, int priority, const char *callerid, int matchcid, const char *registrar)
int	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 a context include.
int	ast_context_remove_include2 (struct ast_context *con, const char *include, const char *registrar)
	Removes an include by an ast_context structure.
int	ast_context_remove_switch (const char *context, const char *sw, const char *data, const char *registrar)
	Remove a switch.
int	ast_context_remove_switch2 (struct ast_context *con, const char *sw, const char *data, const char *registrar)
	This function locks given context, removes switch, unlock context and return.
int	ast_context_unlockmacro (const char *context)
	Unlocks the macrolock in the given context.
int	ast_context_verify_includes (struct ast_context *con)
	Verifies includes in an ast_contect structure.
ast_custom_function *	ast_custom_function_find (const char *name)
int	ast_custom_function_register (struct ast_custom_function *acf)
	Reigster a custom function.
int	ast_custom_function_unregister (struct ast_custom_function *acf)
	Unregister a custom function.
int	ast_exists_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Determine whether an extension exists.
int	ast_explicit_goto (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_extension_close (const char *pattern, const char *data, int needmore)
int	ast_extension_match (const char *pattern, const char *data)
	Determine if a given extension matches a given pattern (in NXX format).
int	ast_extension_state (struct ast_channel *c, const char *context, const char *exten)
	Uses hint and devicestate callback to get the state of an extension.
static int	ast_extension_state2 (struct ast_exten *e)
	ast_extensions_state2: Check state of extension by using hints
const char *	ast_extension_state2str (int extension_state)
	Return string representation of the state of an extension.
int	ast_extension_state_add (const char *context, const char *exten, ast_state_cb_type callback, void *data)
	Registers a state change callback.
int	ast_extension_state_del (int id, ast_state_cb_type callback)
	Deletes a registered state change callback by ID.
int	ast_findlabel_extension (struct ast_channel *c, const char *context, const char *exten, const char *label, const char *callerid)
	Find the priority of an extension that has the specified label.
int	ast_findlabel_extension2 (struct ast_channel *c, struct ast_context *con, const char *exten, const char *label, const char *callerid)
	Find the priority of an extension that has the specified label.
int	ast_func_read (struct ast_channel *chan, char *function, char *workspace, size_t len)
	executes a read operation on a function
int	ast_func_write (struct ast_channel *chan, char *function, const char *value)
	executes a write operation on a function
const char *	ast_get_context_name (struct ast_context *con)
const char *	ast_get_context_registrar (struct ast_context *c)
const char *	ast_get_extension_app (struct ast_exten *e)
void *	ast_get_extension_app_data (struct ast_exten *e)
const char *	ast_get_extension_cidmatch (struct ast_exten *e)
ast_context *	ast_get_extension_context (struct ast_exten *exten)
const char *	ast_get_extension_label (struct ast_exten *exten)
int	ast_get_extension_matchcid (struct ast_exten *e)
const char *	ast_get_extension_name (struct ast_exten *exten)
int	ast_get_extension_priority (struct ast_exten *exten)
const char *	ast_get_extension_registrar (struct ast_exten *e)
int	ast_get_hint (char *hint, int hintsize, char *name, int namesize, struct ast_channel *c, const char *context, const char *exten)
	If an extension exists, return non-zero.
const char *	ast_get_ignorepat_name (struct ast_ignorepat *ip)
const char *	ast_get_ignorepat_registrar (struct ast_ignorepat *ip)
const char *	ast_get_include_name (struct ast_include *inc)
const char *	ast_get_include_registrar (struct ast_include *i)
const char *	ast_get_switch_data (struct ast_sw *sw)
const char *	ast_get_switch_name (struct ast_sw *sw)
const char *	ast_get_switch_registrar (struct ast_sw *sw)
int	ast_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority)
static struct ast_exten *	ast_hint_extension (struct ast_channel *c, const char *context, const char *exten)
	ast_hint_extension: Find hint for given extension in context
void	ast_hint_state_changed (const char *device)
int	ast_ignore_pattern (const char *context, const char *pattern)
	Checks to see if a number should be ignored.
	AST_LIST_HEAD (store_hints, store_hint)
static	AST_LIST_HEAD_STATIC (hints, ast_hint)
static	AST_LIST_HEAD_STATIC (switches, ast_switch)
static	AST_LIST_HEAD_STATIC (apps, ast_app)
static	AST_LIST_HEAD_STATIC (acf_root, ast_custom_function)
int	ast_lock_context (struct ast_context *con)
	Locks a given context.
int	ast_lock_contexts ()
	Locks the context list.
int	ast_matchmore_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Looks to see if adding anything to this extension might match something. (exists ^ canmatch).
void	ast_merge_contexts_and_delete (struct ast_context **extcontexts, const char *registrar)
	Merge the temporary contexts into a global contexts list and delete from the global list the ones that are being added.
	AST_MUTEX_DEFINE_STATIC (maxcalllock)
	AST_MUTEX_DEFINE_STATIC (globalslock)
int	ast_parseable_goto (struct ast_channel *chan, const char *goto_string)
int	ast_pbx_outgoing_app (const char *type, int format, void *data, int timeout, const char *app, const char *appdata, int *reason, int sync, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel)
static int	ast_pbx_outgoing_cdr_failed (void)
int	ast_pbx_outgoing_exten (const char *type, int format, void *data, int timeout, const char *context, const char *exten, int priority, int *reason, int sync, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **channel)
enum ast_pbx_result	ast_pbx_run (struct ast_channel *c)
	Execute the PBX in the current thread.
static void *	ast_pbx_run_app (void *data)
	run the application and free the descriptor once done
enum ast_pbx_result	ast_pbx_start (struct ast_channel *c)
	Create a new thread and start the PBX.
int	ast_rdlock_contexts (void)
int	ast_register_application (const char *app, int(*execute)(struct ast_channel *, void *), const char *synopsis, const char *description)
	Register an application.
int	ast_register_switch (struct ast_switch *sw)
	Register an alternative dialplan switch.
static int	ast_remove_hint (struct ast_exten *e)
	ast_remove_hint: Remove hint from extension
	AST_RWLOCK_DEFINE_STATIC (conlock)
int	ast_spawn_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Launch a new extension (i.e. new stack).
	AST_THREADSTORAGE (switch_data, switch_data_init)
int	ast_unlock_context (struct ast_context *con)
int	ast_unlock_contexts ()
	Unlocks contexts.
int	ast_unregister_application (const char *app)
	Unregister an application.
void	ast_unregister_switch (struct ast_switch *sw)
	Unregister an alternative switch.
ast_exten *	ast_walk_context_extensions (struct ast_context *con, struct ast_exten *exten)
ast_ignorepat *	ast_walk_context_ignorepats (struct ast_context *con, struct ast_ignorepat *ip)
ast_include *	ast_walk_context_includes (struct ast_context *con, struct ast_include *inc)
ast_sw *	ast_walk_context_switches (struct ast_context *con, struct ast_sw *sw)
ast_context *	ast_walk_contexts (struct ast_context *con)
ast_exten *	ast_walk_extension_priorities (struct ast_exten *exten, struct ast_exten *priority)
int	ast_wrlock_contexts (void)
static void *	async_wait (void *data)
static int	collect_digits (struct ast_channel *c, int waittime, char *buf, int buflen, int pos)
	collect digits from the channel into the buffer, return -1 on error, 0 on timeout or done.
static char *	complete_show_application (const char *line, const char *word, int pos, int state)
static char *	complete_show_applications (const char *line, const char *word, int pos, int state)
static char *	complete_show_applications_deprecated (const char *line, const char *word, int pos, int state)
static char *	complete_show_dialplan_context (const char *line, const char *word, int pos, int state)
static char *	complete_show_function (const char *line, const char *word, int pos, int state)
static void	decrease_call_count (void)
static void	destroy_exten (struct ast_exten *e)
static int	ext_cmp (const char *a, const char *b)
	the full routine to compare extensions in rules.
static int	ext_cmp1 (const char **p)
	helper functions to sort extensions and patterns in the desired way, so that more specific patterns appear first.
static int	ext_strncpy (char *dst, const char *src, int len)
	copy a string skipping whitespace
static int	extension_match_core (const char *pattern, const char *data, enum ext_match_t mode)
static struct ast_context *	find_context_locked (const char *context)
static char *	func_args (char *function)
	return a pointer to the arguments of the function, and terminates the function name with '\0'
static unsigned	get_range (char *src, int max, char *const names[], const char *msg)
	helper function to return a range up to max (7, 12, 31 respectively). names, if supplied, is an array of names that should be mapped to numbers.
static void	get_timerange (struct ast_timing *i, char *times)
	store a bitmask of valid times, one bit each 2 minute
static int	handle_set_global (int fd, int argc, char *argv[])
static int	handle_set_global_deprecated (int fd, int argc, char *argv[])
	CLI support for setting global variables.
static int	handle_show_application (int fd, int argc, char *argv[])
static int	handle_show_application_deprecated (int fd, int argc, char *argv[])
static int	handle_show_applications (int fd, int argc, char *argv[])
static int	handle_show_applications_deprecated (int fd, int argc, char *argv[])
static int	handle_show_dialplan (int fd, int argc, char *argv[])
static int	handle_show_function (int fd, int argc, char *argv[])
static int	handle_show_function_deprecated (int fd, int argc, char *argv[])
static int	handle_show_functions (int fd, int argc, char *argv[])
static int	handle_show_functions_deprecated (int fd, int argc, char *argv[])
static int	handle_show_globals (int fd, int argc, char *argv[])
	CLI support for listing global variables in a parseable way.
static int	handle_show_hints (int fd, int argc, char *argv[])
	handle_show_hints: CLI support for listing registred dial plan hints
static int	handle_show_switches (int fd, int argc, char *argv[])
	handle_show_switches: CLI support for listing registred dial plan switches
static int	include_valid (struct ast_include *i)
static int	increase_call_count (const struct ast_channel *c)
int	load_pbx (void)
static int	lookup_name (const char *s, char *const names[], int max)
	Helper for get_range. return the index of the matching entry, starting from 1. If names is not supplied, try numeric values.
static int	matchcid (const char *cidpattern, const char *callerid)
static int	parse_variable_name (char *var, int *offset, int *length, int *isfunc)
	extract offset:length from variable name. Returns 1 if there is a offset:length part, which is trimmed off (values go into variables)
static int	pbx_builtin_answer (struct ast_channel *, void *)
static int	pbx_builtin_background (struct ast_channel *, void *)
static int	pbx_builtin_busy (struct ast_channel *, void *)
void	pbx_builtin_clear_globals (void)
static int	pbx_builtin_congestion (struct ast_channel *, void *)
static int	pbx_builtin_execiftime (struct ast_channel *, void *)
const char *	pbx_builtin_getvar_helper (struct ast_channel *chan, const char *name)
static int	pbx_builtin_goto (struct ast_channel *, void *)
static int	pbx_builtin_gotoif (struct ast_channel *, void *)
static int	pbx_builtin_gotoiftime (struct ast_channel *, void *)
static int	pbx_builtin_hangup (struct ast_channel *, void *)
static int	pbx_builtin_importvar (struct ast_channel *, void *)
static int	pbx_builtin_noop (struct ast_channel *, void *)
static int	pbx_builtin_progress (struct ast_channel *, void *)
void	pbx_builtin_pushvar_helper (struct ast_channel *chan, const char *name, const char *value)
static int	pbx_builtin_resetcdr (struct ast_channel *, void *)
static int	pbx_builtin_ringing (struct ast_channel *, void *)
static int	pbx_builtin_saycharacters (struct ast_channel *, void *)
static int	pbx_builtin_saydigits (struct ast_channel *, void *)
static int	pbx_builtin_saynumber (struct ast_channel *, void *)
static int	pbx_builtin_sayphonetic (struct ast_channel *, void *)
int	pbx_builtin_serialize_variables (struct ast_channel *chan, char *buf, size_t size)
static int	pbx_builtin_setamaflags (struct ast_channel *, void *)
static int	pbx_builtin_setglobalvar (struct ast_channel *, void *)
int	pbx_builtin_setvar (struct ast_channel *, void *)
void	pbx_builtin_setvar_helper (struct ast_channel *chan, const char *name, const char *value)
static int	pbx_builtin_wait (struct ast_channel *, void *)
static int	pbx_builtin_waitexten (struct ast_channel *, void *)
int	pbx_checkcondition (const char *condition)
	Evaluate a condition.
static void	pbx_destroy (struct ast_pbx *p)
int	pbx_exec (struct ast_channel *c, struct ast_app *app, void *data)
	Execute an application.
static int	pbx_extension_helper (struct ast_channel *c, struct ast_context *con, const char *context, const char *exten, int priority, const char *label, const char *callerid, enum ext_match_t action)
	The return value depends on the action:.
static struct ast_exten *	pbx_find_extension (struct ast_channel *chan, struct ast_context *bypass, struct pbx_find_info *q, const char *context, const char *exten, int priority, const char *label, const char *callerid, enum ext_match_t action)
ast_app *	pbx_findapp (const char *app)
	Look up an application.
static struct ast_switch *	pbx_findswitch (const char *sw)
void	pbx_retrieve_variable (struct ast_channel *c, const char *var, char **ret, char *workspace, int workspacelen, struct varshead *headp)
	pbx_retrieve_variable: Support for Asterisk built-in variables ---
int	pbx_set_autofallthrough (int newval)
static void	pbx_substitute_variables (char *passdata, int datalen, struct ast_channel *c, struct ast_exten *e)
void	pbx_substitute_variables_helper (struct ast_channel *c, const char *cp1, char *cp2, int count)
static void	pbx_substitute_variables_helper_full (struct ast_channel *c, struct varshead *headp, const char *cp1, char *cp2, int count)
void	pbx_substitute_variables_varshead (struct varshead *headp, const char *cp1, char *cp2, int count)
static void *	pbx_thread (void *data)
static void	print_ext (struct ast_exten *e, char *buf, int buflen)
	helper function to print an extension
static void	set_ext_pri (struct ast_channel *c, const char *exten, int pri)
static int	show_dialplan_helper (int fd, const char *context, const char *exten, struct dialplan_counters *dpc, struct ast_include *rinclude, int includecount, const char *includes[])
static char *	substring (const char *value, int offset, int length, char *workspace, size_t workspace_len)
	takes a substring. It is ok to call with value == workspace.
static void	wait_for_hangup (struct ast_channel *chan, void *data)
Variables
static int	autofallthrough = 1
static struct pbx_builtin	builtins []
	Declaration of builtin applications.
static struct ast_cli_entry	cli_set_global_deprecated
static struct ast_cli_entry	cli_show_application_deprecated
static struct ast_cli_entry	cli_show_applications_deprecated
static struct ast_cli_entry	cli_show_dialplan_deprecated
static struct ast_cli_entry	cli_show_function_deprecated
static struct ast_cli_entry	cli_show_functions_deprecated
static struct ast_cli_entry	cli_show_globals_deprecated
static struct ast_cli_entry	cli_show_hints_deprecated
static struct ast_cli_entry	cli_show_switches_deprecated
static struct ast_context *	contexts
static int	countcalls
static char *	days []
static struct cfextension_states	extension_states []
static struct varshead	globals = AST_LIST_HEAD_NOLOCK_INIT_VALUE
static char *	months []
static struct ast_cli_entry	pbx_cli []
static char	set_global_help []
static char	show_application_help []
static char	show_applications_help []
static char	show_dialplan_help []
static char	show_function_help []
static char	show_functions_help []
static char	show_globals_help []
static char	show_hints_help []
static char	show_switches_help []
ast_state_cb *	statecbs
static int	stateid = 1

---

Detailed Description

Core PBX routines.

Author:

Mark Spencer <markster@digium.com>

Definition in file pbx.c.

---

Define Documentation

#define AST_PBX_MAX_STACK   128

Go no deeper than this through includes (not counting loops)

Definition at line 549 of file pbx.c.

Referenced by handle_show_dialplan(), pbx_find_extension(), and show_dialplan_helper().

#define BACKGROUND_MATCHEXTEN   (1 << 2)

Definition at line 91 of file pbx.c.

Referenced by pbx_builtin_background().

#define BACKGROUND_NOANSWER   (1 << 1)

Definition at line 90 of file pbx.c.

Referenced by pbx_builtin_background().

#define BACKGROUND_PLAYBACK   (1 << 3)

Definition at line 92 of file pbx.c.

Referenced by pbx_builtin_background().

#define BACKGROUND_SKIP   (1 << 0)

Definition at line 89 of file pbx.c.

Referenced by pbx_builtin_background().

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

Definition at line 78 of file pbx.c.

Referenced by pbx_extension_helper(), and realtime_exec().

#define SAY_STUBS

Definition at line 55 of file pbx.c.

#define STATUS_NO_CONTEXT   1

Definition at line 911 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_NO_EXTENSION   2

Definition at line 912 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_NO_LABEL   4

Definition at line 914 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_NO_PRIORITY   3

Definition at line 913 of file pbx.c.

Referenced by pbx_extension_helper(), and pbx_find_extension().

#define STATUS_SUCCESS   5

Definition at line 915 of file pbx.c.

Referenced by pbx_find_extension().

#define SWITCH_DATA_LENGTH   256

Definition at line 81 of file pbx.c.

#define VAR_BUF_SIZE   4096

Definition at line 83 of file pbx.c.

Referenced by ast_add_extension2(), pbx_builtin_importvar(), and pbx_substitute_variables_helper_full().

#define VAR_HARDTRAN   3

Definition at line 87 of file pbx.c.

#define VAR_NORMAL   1

Definition at line 85 of file pbx.c.

#define VAR_SOFTTRAN   2

Definition at line 86 of file pbx.c.

#define WAITEXTEN_MOH   (1 << 0)

Definition at line 101 of file pbx.c.

Referenced by pbx_builtin_waitexten().

---

Enumeration Type Documentation

enum ext_match_t

When looking up extensions, we can have different requests identified by the 'action' argument, as follows. Note that the coding is such that the low 4 bits are the third argument to extension_match_core.

Enumerator:

E_MATCHMORE
E_CANMATCH
E_MATCH
E_MATCH_MASK
E_SPAWN
E_FINDLABEL

Definition at line 754 of file pbx.c.

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

---

Function Documentation

static struct ast_context* __ast_context_create	(	struct ast_context **	extcontexts,
		const char *	name,
		const char *	registrar,
		int	existsokay
	)			[static]

Definition at line 3858 of file pbx.c.

References ast_log(), ast_rdlock_contexts(), ast_unlock_contexts(), contexts, local_contexts, LOG_WARNING, name, and ast_context::next.

Referenced by ast_context_create(), and ast_context_find_or_create().

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

   if (!extcontexts) {
      ast_rdlock_contexts();
      local_contexts = &contexts;
   } else
      local_contexts = extcontex