Home page | Mailing list | Docs

Last updated: Sat Feb 3 05:01:39 2007

Asterisk developer's documentation :: Codename Pineapple

---

pbx.h File Reference

---

Detailed Description

Core PBX routines and definitions.

Definition in file pbx.h.

#include "asterisk/sched.h"
#include "asterisk/channel.h"
#include "asterisk/linkedlists.h"

Include dependency graph for pbx.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	ast_custom_function
	Data structure associated with a custom dialplan function. More...
struct	ast_pbx
struct	ast_switch
struct	ast_timing
Functions for returning values from structures
const char *	ast_get_context_name (struct ast_context *con)
ast_context *	ast_get_extension_context (struct ast_exten *exten)
const char *	ast_get_extension_name (struct ast_exten *exten)
const char *	ast_get_ignorepat_name (struct ast_ignorepat *ip)
const char *	ast_get_include_name (struct ast_include *include)
const char *	ast_get_switch_data (struct ast_sw *sw)
const char *	ast_get_switch_name (struct ast_sw *sw)
Registrar info functions ...
const char *	ast_get_context_registrar (struct ast_context *c)
const char *	ast_get_extension_registrar (struct ast_exten *e)
const char *	ast_get_ignorepat_registrar (struct ast_ignorepat *ip)
const char *	ast_get_include_registrar (struct ast_include *i)
const char *	ast_get_switch_registrar (struct ast_sw *sw)
Other Extension stuff
const char *	ast_get_extension_app (struct ast_exten *e)
void *	ast_get_extension_app_data (struct ast_exten *e)
const char *	ast_get_extension_cidmatch (struct ast_exten *e)
const char *	ast_get_extension_label (struct ast_exten *e)
int	ast_get_extension_matchcid (struct ast_exten *e)
int	ast_get_extension_priority (struct ast_exten *exten)
Defines
#define	AST_MAX_APP   32
#define	AST_PBX_KEEP   0
#define	AST_PBX_KEEPALIVE   10
	Special return values from applications to the PBX {.
#define	AST_PBX_NO_HANGUP_PEER   11
#define	AST_PBX_REPLACE   1
#define	PRIORITY_HINT   -1
Typedefs
typedef int(*	ast_state_cb_type )(char *context, char *id, enum ast_extension_states state, void *data)
	Typedef for devicestate and hint callbacks.
typedef int()	ast_switch_f (struct ast_channel *chan, const char *context, const char *exten, int priority, const char *callerid, const char *data)
	All switch functions have the same interface, so define a type for them.
Enumerations
enum	ast_extension_states {   AST_EXTENSION_REMOVED = -2, AST_EXTENSION_DEACTIVATED = -1, AST_EXTENSION_NOT_INUSE = 0, AST_EXTENSION_INUSE = 1 << 0,   AST_EXTENSION_BUSY = 1 << 1, AST_EXTENSION_UNAVAILABLE = 1 << 2, AST_EXTENSION_RINGING = 1 << 3, AST_EXTENSION_ONHOLD = 1 << 4 }
	Extension states. More...
enum	ast_pbx_result { AST_PBX_SUCCESS = 0, AST_PBX_FAILED = -1, AST_PBX_CALL_LIMIT = -2 }
	The result codes when starting the PBX on a channel with ast_pbx_start(). More...
Functions
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 *.
int	ast_async_goto (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_async_goto_by_name (const char *chan, 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)
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.
int	ast_check_timing (const struct ast_timing *i)
int	ast_context_add_ignorepat (const char *context, const char *ignorepat, const char *registrar)
	Add an ignorepat.
int	ast_context_add_ignorepat2 (struct ast_context *con, const char *ignorepat, const char *registrar)
int	ast_context_add_include (const char *context, const char *include, const char *registrar)
	Add a context include.
int	ast_context_add_include2 (struct ast_context *con, const char *include, 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 *sw, 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)
	Register a new context or find an existing one.
int	ast_context_lockmacro (const char *macrocontext)
	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_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 *macrocontext)
	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 *extension)
	Determine if a given extension matches a given pattern (in NXX format).
int	ast_extension_patmatch (const char *pattern, const char *data)
int	ast_extension_state (struct ast_channel *c, const char *context, const char *exten)
	Uses hint and devicestate callback to get the state of an extension.
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, const char *function, char *workspace, size_t len)
	executes a read operation on a function
int	ast_func_write (struct ast_channel *chan, const char *function, const char *value)
	executes a write operation on a function
int	ast_get_hint (char *hint, int maxlen, char *name, int maxnamelen, struct ast_channel *c, const char *context, const char *exten)
	If an extension hint exists, return non-zero.
int	ast_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority)
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.
int	ast_lock_context (struct ast_context *con)
	Locks a given context.
int	ast_lock_contexts (void)
	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.
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)
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 **locked_channel)
enum ast_pbx_result	ast_pbx_run (struct ast_channel *c)
	Execute the PBX in the current thread.
enum ast_pbx_result	ast_pbx_start (struct ast_channel *c)
	Create a new thread and start the PBX.
int	ast_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.
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).
int	ast_unlock_context (struct ast_context *con)
int	ast_unlock_contexts (void)
	Unlocks contexts.
int	ast_unregister_application (const char *app)
	Unregister an application.
void	ast_unregister_switch (struct ast_switch *sw)
	Unregister an alternative switch.
ast_exten *	ast_walk_context_extensions (struct ast_context *con, struct ast_exten *priority)
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)
void	pbx_builtin_clear_globals (void)
const char *	pbx_builtin_getvar_helper (struct ast_channel *chan, const char *name)
void	pbx_builtin_pushvar_helper (struct ast_channel *chan, const char *name, const char *value)
int	pbx_builtin_serialize_variables (struct ast_channel *chan, struct ast_str **buf)
int	pbx_builtin_setvar (struct ast_channel *chan, void *data)
void	pbx_builtin_setvar_helper (struct ast_channel *chan, const char *name, const char *value)
int	pbx_checkcondition (const char *condition)
	Evaluate a condition.
int	pbx_exec (struct ast_channel *c, struct ast_app *app, void *data)
	Execute an application.
ast_app *	pbx_findapp (const char *app)
	Look up an application.
void	pbx_retrieve_variable (struct ast_channel *c, const char *var, char **ret, char *workspace, int workspacelen, struct varshead *headp)
	Support for Asterisk built-in variables in the dialplan.
int	pbx_set_autofallthrough (int newval)
void	pbx_substitute_variables_helper (struct ast_channel *c, const char *cp1, char *cp2, int count)
void	pbx_substitute_variables_varshead (struct varshead *headp, const char *cp1, char *cp2, int count)

---

Define Documentation

#define AST_MAX_APP   32

Max length of an application Definition at line 34 of file pbx.h. Referenced by handle_show_application(), and handle_show_function().

#define AST_PBX_KEEP   0

Definition at line 36 of file pbx.h.

#define AST_PBX_KEEPALIVE   10

Special return values from applications to the PBX {. Destroy the thread, but don't hang up the channel Definition at line 40 of file pbx.h. Referenced by agi_handle_command(), builtin_blindtransfer(), builtin_parkcall(), feature_exec_app(), park_call_exec(), and run_agi().

#define AST_PBX_NO_HANGUP_PEER   11

Definition at line 41 of file pbx.h. Referenced by builtin_blindtransfer(), builtin_parkcall(), feature_exec_app(), and park_exec().

#define AST_PBX_REPLACE   1

Definition at line 37 of file pbx.h.

#define PRIORITY_HINT   -1

} Special Priority for a hint Definition at line 44 of file pbx.h. Referenced by add_extensions(), ast_add_extension2(), ast_hint_extension(), destroy_exten(), handle_context_add_extension(), handle_context_remove_extension(), handle_save_dialplan(), manager_show_dialplan_helper(), park_add_hints(), and print_ext().

---

Typedef Documentation

typedef int(* ast_state_cb_type)(char *context, char *id, enum ast_extension_states state, void *data)

Typedef for devicestate and hint callbacks. Definition at line 69 of file pbx.h.

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

All switch functions have the same interface, so define a type for them. Data structure associated with an Asterisk switch Definition at line 83 of file pbx.h.

---

Enumeration Type Documentation

enum ast_extension_states

Extension states. Note: States can be combined Extension and device states in Asterisk Enumerator: AST_EXTENSION_REMOVED  Extension removed AST_EXTENSION_DEACTIVATED  Extension hint removed AST_EXTENSION_NOT_INUSE  No device INUSE or BUSY AST_EXTENSION_INUSE  One or more devices INUSE AST_EXTENSION_BUSY  All devices BUSY AST_EXTENSION_UNAVAILABLE  All devices UNAVAILABLE/UNREGISTERED AST_EXTENSION_RINGING  All devices RINGING AST_EXTENSION_ONHOLD  All devices ONHOLD Definition at line 50 of file pbx.h. { AST_EXTENSION_REMOVED = -2, /*!< Extension removed */ AST_EXTENSION_DEACTIVATED = -1, /*!< Extension hint removed */ AST_EXTENSION_NOT_INUSE = 0, /*!< No device INUSE or BUSY */ AST_EXTENSION_INUSE = 1 << 0, /*!< One or more devices INUSE */ AST_EXTENSION_BUSY = 1 << 1, /*!< All devices BUSY */ AST_EXTENSION_UNAVAILABLE = 1 << 2, /*!< All devices UNAVAILABLE/UNREGISTERED */ AST_EXTENSION_RINGING = 1 << 3, /*!< All devices RINGING */ AST_EXTENSION_ONHOLD = 1 << 4, /*!< All devices ONHOLD */ };

enum ast_pbx_result

The result codes when starting the PBX on a channel with ast_pbx_start(). AST_PBX_CALL_LIMIT refers to the maxcalls call limit in asterisk.conf Enumerator: AST_PBX_SUCCESS  AST_PBX_FAILED  AST_PBX_CALL_LIMIT  Definition at line 236 of file pbx.h. { AST_PBX_SUCCESS = 0, AST_PBX_FAILED = -1, AST_PBX_CALL_LIMIT = -2, };

---

Function Documentation

int ast_active_calls (  void   )

Retrieve the number of active calls. Definition at line 2530 of file pbx.c. References countcalls. Referenced by handle_chanlist(). { return countcalls; }

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

Add and extension to an extension context. Parameters: context  context to add the extension to replace  extension  extension to add priority  priority level of extension addition label  extension label callerid  pattern to match CallerID, or NULL to match any CallerID application  application to run on the extension with that priority level data  data to pass to the application datad  registrar  who registered the extension Return values: 0  success -1  failure Definition at line 4448 of file pbx.c. References ast_add_extension2(), ast_unlock_contexts(), and find_context_locked(). Referenced by handle_context_add_extension(), park_add_hints(), and register_peer_exten(). { int ret = -1; struct ast_context *c = find_context_locked(context); if (c) { ret = ast_add_extension2(c, replace, extension, priority, label, callerid, application, data, datad, registrar); ast_unlock_contexts(); } return ret; }

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

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 4649 of file pbx.c. References add_pri(), ast_exten::app, ast_add_hint(), ast_calloc, AST_LIST_FIRST, ast_log(), ast_mutex_lock(), ast_mutex_unlock(), ast_rwlock_rdlock(), ast_rwlock_unlock(), ast_verbose(), ast_exten::cidmatch, ast_exten::data, ast_exten::datad, el, ext_cmp(), ext_strncpy(), ast_exten::exten, ast_exten::label, ast_context::lock, ast_exten::matchcid, ast_exten::next, option_verbose, ast_exten::parent, pbx_substitute_variables_varshead(), ast_exten::priority, PRIORITY_HINT, ast_exten::registrar, ast_context::root, ast_exten::stuff, VAR_BUF_SIZE, and VERBOSE_PREFIX_3. Referenced by add_extensions(), ast_add_extension(), and do_parking_thread(). { /* * 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, *e, *el = NULL; int res; int length; char *p; char expand_buf[VAR_BUF_SIZE] = { 0, }; /* if we are adding a hint, and there are global variables, and the hint contains variable references, then expand them */ ast_rwlock_rdlock(&globalslock); if (priority == PRIORITY_HINT && AST_LIST_FIRST(&globals) && strstr(application, "${")) { pbx_substitute_variables_varshead(&globals, application, expand_buf, sizeof(expand_buf)); application = expand_buf; } ast_rwlock_unlock(&globalslock); length = sizeof(struct ast_exten); length += strlen(extension) + 1; length += strlen(application) + 1; if (label) length += strlen(label) + 1; if (callerid) length += strlen(callerid) + 1; else length ++; /* just the '\0' */ /* Be optimistic: Build the extension structure first */ if (!(tmp = ast_calloc(1, length))) return -1; /* use p as dst in assignments, as the fields are const char * */ p = tmp->stuff; if (label) { tmp->label = p; strcpy(p, label); p += strlen(label) + 1; } tmp->exten = p; p += ext_strncpy(p, extension, strlen(extension) + 1) + 1; tmp->priority = priority; tmp->cidmatch = p; /* but use p for assignments below */ if (callerid) { p += ext_strncpy(p, callerid, strlen(callerid) + 1) + 1; tmp->matchcid = 1; } else { *p++ = '\0'; tmp->matchcid = 0; } tmp->app = p; strcpy(p, application); tmp->parent = con; tmp->data = data; tmp->datad = datad; tmp->registrar = registrar; ast_mutex_lock(&con->lock); 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, extension); if (res == 0) { /* extension match, now look at cidmatch */ if (!e->matchcid && !tmp->matchcid) res = 0; else if (tmp->matchcid && !e->matchcid) res = 1; else if (e->matchcid && !tmp->matchcid) res = -1; else res = strcasecmp(e->cidmatch, tmp->cidmatch); } if (res >= 0) break; } if (e && res == 0) { /* exact match, insert in the pri chain */ res = add_pri(con, tmp, el, e, replace); ast_mutex_unlock(&con->lock); if (res < 0) { errno = EEXIST; /* XXX do we care ? */ return 0; /* XXX should we return -1 maybe ? */ } } else { /* * not an exact match, this is the first entry with this pattern, * so insert in the main list right before 'e' (if any) */ tmp->next = e; if (el) el->next = tmp; else con->root = tmp; ast_mutex_unlock(&con->lock); if (tmp->priority == PRIORITY_HINT) ast_add_hint(tmp); } if (option_debug) { if (tmp->matchcid) { if (option_debug) ast_log(LOG_DEBUG, "Added extension '%s' priority %d (CID match '%s') to %s\n", tmp->exten, tmp->priority, tmp->cidmatch, con->name); } else { if (option_debug) ast_log(LOG_DEBUG, "Added extension '%s' priority %d to %s\n", tmp->exten, tmp->priority, con->name); } } if (option_verbose > 2) { if (tmp->matchcid) { ast_verbose( VERBOSE_PREFIX_3 "Added extension '%s' priority %d (CID match '%s')to %s\n", tmp->exten, tmp->priority, tmp->cidmatch, con->name); } else { ast_verbose( VERBOSE_PREFIX_3 "Added extension '%s' priority %d to %s\n", tmp->exten, tmp->priority, con->name); } } return 0; }

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

Definition at line 4482 of file pbx.c. References ast_channel::_state, ast_channel_alloc(), ast_channel_lock, ast_channel_masquerade(), ast_channel_unlock, ast_do_masquerade(), ast_explicit_goto(), ast_hangup(), ast_log(), ast_pbx_start(), AST_SOFTHANGUP_ASYNCGOTO, ast_softhangup_nolock(), ast_channel::context, ast_channel::exten, LOG_WARNING, ast_channel::pbx, ast_channel::readformat, S_OR, and ast_channel::writeformat. Referenced by __ast_goto_if_exists(), action_redirect(), ast_async_goto_by_name(), builtin_blindtransfer(), console_transfer(), handle_request_bye(), handle_request_refer(), process_ast_dsp(), socket_process(), and zt_read(). { int res = 0; ast_channel_lock(chan); if (chan->pbx) { /* This channel is currently in the PBX */ ast_explicit_goto(chan, context, exten, priority); ast_softhangup_nolock(chan, AST_SOFTHANGUP_ASYNCGOTO); } else { /* In order to do it when the channel doesn't really exist within the PBX, we have to make a new channel, masquerade, and start the PBX at the new location */ struct ast_channel *tmpchan = ast_channel_alloc(0, chan->_state, 0, 0, "AsyncGoto/%s", chan->name); if (!tmpchan) res = -1; else { /* Make formats okay */ tmpchan->readformat = chan->readformat; tmpchan->writeformat = chan->writeformat; /* Setup proper location */ ast_explicit_goto(tmpchan, S_OR(context, chan->context), S_OR(exten, chan->exten), priority); /* Masquerade into temp channel */ ast_channel_masquerade(tmpchan, chan); /* Grab the locks and get going */ ast_channel_lock(tmpchan); ast_do_masquerade(tmpchan); ast_channel_unlock(tmpchan); /* Start the PBX going on our stolen channel */ if (ast_pbx_start(tmpchan)) { ast_log(LOG_WARNING, "Unable to start PBX on %s\n", tmpchan->name); ast_hangup(tmpchan); res = -1; } } } ast_channel_unlock(chan); return res; }

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

Definition at line 4525 of file pbx.c. References ast_async_goto(), ast_channel_unlock, and ast_get_channel_by_name_locked(). { struct ast_channel *chan; int res = -1; chan = ast_get_channel_by_name_locked(channame); if (chan) { res = ast_async_goto(chan, context, exten, priority); ast_channel_unlock(chan); } return res; }

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

Definition at line 6185 of file pbx.c. References __ast_goto_if_exists(). { return __ast_goto_if_exists(chan, context, exten, priority, 1); }

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

Definition at line 4124 of file pbx.c. References ast_strlen_zero(), ast_timing::daymask, ast_timing::dowmask, get_range(), get_timerange(), ast_timing::monthmask, and strsep(). Referenced by ast_context_add_include2(), pbx_builtin_execiftime(), and pbx_builtin_gotoiftime(). { char info_save[256]; char *info; /* Check for empty just in case */ if (ast_strlen_zero(info_in)) return 0; /* make a copy just in case we were passed a static string */ ast_copy_string(info_save, info_in, sizeof(info_save)); info = info_save; /* Assume everything except time */ i->monthmask = 0xfff; /* 12 bits */ i->daymask = 0x7fffffffU; /* 31 bits */ i->dowmask = 0x7f; /* 7 bits */ /* on each call, use strsep() to move info to the next argument */ get_timerange(i, strsep(&info, "|")); if (info) i->dowmask = get_range(strsep(&info, "|"), 7, days, "day of week"); if (info) i->daymask = get_range(strsep(&info, "|"), 31, NULL, "day"); if (info) i->monthmask = get_range(strsep(&info, "|"), 12, months, "month"); return 1; }

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

Looks for a valid matching extension. Parameters: c  not really important context  context to serach within exten  extension to check priority  priority of extension path callerid  callerid of extension being searched for 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 2158 of file pbx.c. References E_CANMATCH, and pbx_extension_helper(). Referenced by cb_events(), dp_lookup(), dundi_lookup_local(), get_also_info(), get_destination(), loopback_canmatch(), mgcp_ss(), phone_check_exception(), skinny_ss(), and ss_thread(). { return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_CANMATCH); }

int ast_check_timing (  const struct ast_timing *  i  )

Definition at line 4150 of file pbx.c. References ast_log(), ast_timing::daymask, ast_timing::dowmask, LOG_WARNING, ast_timing::minmask, and ast_timing::monthmask. Referenced by include_valid(), pbx_builtin_execiftime(), and pbx_builtin_gotoiftime(). { struct tm tm; time_t t = time(NULL); localtime_r(&t,&tm); /* If it's not the right month, return */ if (!(i->monthmask & (1 << tm.tm_mon))) return 0; /* If it's not that time of the month.... */ /* Warning, tm_mday has range 1..31! */ if (!(i->daymask & (1 << (tm.tm_mday-1)))) return 0; /* If it's not the right day of the week */ if (!(i->dowmask & (1 << tm.tm_wday))) return 0; /* Sanity check the hour just to be safe */ if ((tm.tm_hour < 0) || (tm.tm_hour > 23)) { ast_log(LOG_WARNING, "Insane time...\n"); return 0; } /* Now the tough part, we calculate if it fits in the right time based on min/hour */ if (!(i->minmask[tm.tm_hour] & (1 << (tm.tm_min / 2)))) return 0; /* If we got this far, then we're good */ return 1; }

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 4384 of file pbx.c. References ast_context_add_ignorepat2(), ast_unlock_contexts(), and find_context_locked(). Referenced by handle_context_add_ignorepat(). { int ret = -1; struct ast_context *c = find_context_locked(context); if (c) { ret = ast_context_add_ignorepat2(c, value, registrar); ast_unlock_contexts(); } return ret; }

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

Definition at line 4396 of file pbx.c. References ast_calloc, ast_mutex_lock(), ast_mutex_unlock(), ast_context::ignorepats, ast_context::lock, ast_ignorepat::next, ast_ignorepat::pattern, and ast_ignorepat::registrar. Referenced by ast_compile_ael2(), and ast_context_add_ignorepat(). { struct ast_ignorepat *ignorepat, *ignorepatc, *ignorepatl = NULL; int length; length = sizeof(struct ast_ignorepat); length += strlen(value) + 1; if (!(ignorepat = ast_calloc(1, length))) return -1; /* The cast to char * is because we need to write the initial value. * The field is not supposed to be modified otherwise */ strcpy((char *)ignorepat->pattern, value); ignorepat->next = NULL; ignorepat->registrar = registrar; ast_mutex_lock(&con->lock); for (ignorepatc = con->ignorepats; ignorepatc; ignorepatc = ignorepatc->next) { ignorepatl = ignorepatc; if (!strcasecmp(ignorepatc->pattern, value)) { /* Already there */ ast_mutex_unlock(&con->lock); errno = EEXIST; return -1; } } if (ignorepatl) ignorepatl->next = ignorepat; else con->ignorepats = ignorepat; ast_mutex_unlock(&con->lock); return 0; }

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

Add a context include. Parameters: context  context to add include to include  new include to add registrar  who's registering it Adds an include taking a char * string as the context parameter Return values: 0  on success -1  on error Definition at line 3930 of file pbx.c. References ast_context_add_include2(), ast_unlock_contexts(), and find_context_locked(). Referenced by handle_context_add_include(). { int ret = -1; struct ast_context *c = find_context_locked(context); if (c) { ret = ast_context_add_include2(c, include, registrar); ast_unlock_contexts(); } return ret; }

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

Add a context include. Parameters: con  context to add the include to include  include to add registrar  who registered the context Adds an include taking a struct ast_context as the first parameter Return values: 0  on success -1  on failure Definition at line 4192 of file pbx.c. References ast_build_timing(), ast_calloc, ast_get_context_name(), ast_mutex_lock(), ast_mutex_unlock(), ast_verbose(), free, ast_include::hastime, ast_context::includes, ast_context::lock, ast_include::name, ast_include::next, option_verbose, ast_include::registrar, ast_include::rname, ast_include::stuff, ast_include::timing, and VERBOSE_PREFIX_3. Referenced by ast_compile_ael2(), and ast_context_add_include(). { struct ast_include *new_include; char *c; struct ast_include *i, *il = NULL; /* include, include_last */ int length; char *p; length = sizeof(struct ast_include); length += 2 * (strlen(value) + 1); /* allocate new include structure ... */ if (!(new_include = ast_calloc(1, length))) return -1; /* Fill in this structure. Use 'p' for assignments, as the fields * in the structure are 'const char *' */ p = new_include->stuff; new_include->name = p; strcpy(p, value); p += strlen(value) + 1; new_include->rname = p; strcpy(p, value); /* Strip off timing info, and process if it is there */ if ( (c = strchr(p, '|')) ) { *c++ = '\0'; new_include->hastime = ast_build_timing(&(new_include->timing), c); } new_include->next = NULL; new_include->registrar = registrar; ast_mutex_lock(&con->lock); /* ... go to last include and check if context is already included too... */ for (i = con->includes; i; i = i->next) { if (!strcasecmp(i->name, new_include->name)) { free(new_include); ast_mutex_unlock(&con->lock); errno = EEXIST; return -1; } il = i; } /* ... include new context into context list, unlock, return */ if (il) il->next = new_include; else con->includes = new_include; if (option_verbose > 2) ast_verbose(VERBOSE_PREFIX_3 "Including context '%s' in context '%s'\n", new_include->name, ast_get_context_name(con)); ast_mutex_unlock(&con->lock); return 0; }

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

Add a switch. Parameters: context  context to which to add the switch sw  switch to add data  data to pass to switch eval  whether to evaluate variables when running switch registrar  whoever registered the switch This function registers a switch with the asterisk switch architecture Return values: 0  on success -1  on failure Definition at line 4254 of file pbx.c. References ast_context_add_switch2(), ast_unlock_contexts(), and find_context_locked(). { int ret = -1; struct ast_context *c = find_context_locked(context); if (c) { /* found, add switch to this context */ ret = ast_context_add_switch2(c, sw, data, eval, registrar); ast_unlock_contexts(); } return ret; }

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

Adds a switch (first param is a ast_context). Note: See ast_context_add_switch() for argument information, with the exception of the first argument. In this case, it's a pointer to an ast_context structure as opposed to the name. Definition at line 4273 of file pbx.c. References ast_calloc, ast_get_context_name(), AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_mutex_lock(), ast_mutex_unlock(), ast_verbose(), ast_sw::data, ast_sw::eval, free, ast_context::lock, ast_sw::name, option_verbose, ast_sw::registrar, SWITCH_DATA_LENGTH, and VERBOSE_PREFIX_3. Referenced by ast_compile_ael2(), and ast_context_add_switch(). { struct ast_sw *new_sw; struct ast_sw *i; int length; char *p; length = sizeof(struct ast_sw); length += strlen(value) + 1; if (data) length += strlen(data); length++; if (eval) { /* Create buffer for evaluation of variables */ length += SWITCH_DATA_LENGTH; length++; } /* allocate new sw structure ... */ if (!(new_sw = ast_calloc(1, length))) return -1; /* ... fill in this structure ... */ p = new_sw->stuff; new_sw->name = p; strcpy(new_sw->name, value); p += strlen(value) + 1; new_sw->data = p; if (data) { strcpy(new_sw->data, data); p += strlen(data) + 1; } else { strcpy(new_sw->data, ""); p++; } if (eval) new_sw->tmpdata = p; new_sw->eval = eval; new_sw->registrar = registrar; /* ... try to lock this context ... */ ast_mutex_lock(&con->lock); /* ... go to last sw and check if context is already swd too... */ AST_LIST_TRAVERSE(&con->alts, i, list) { if (!strcasecmp(i->name, new_sw->name) && !strcasecmp(i->data, new_sw->data)) { free(new_sw); ast_mutex_unlock(&con->lock); errno = EEXIST; return -1; } } /* ... sw new context into context list, unlock, return */ AST_LIST_INSERT_TAIL(&con->alts, new_sw, list); if (option_verbose > 2) ast_verbose(VERBOSE_PREFIX_3 "Including switch '%s/%s' in context '%s'\n", new_sw->name, new_sw->data, ast_get_context_name(con)); ast_mutex_unlock(&con->lock); return 0; }

struct ast_context* ast_context_create (  struct ast_context **  extcontexts, const char *  name, const char *  registrar )

Register a new context. Parameters: extcontexts  pointer to the ast_context structure pointer name  name of the new context registrar  registrar of the context 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 3801 of file pbx.c. References __ast_context_create(). Referenced by ast_compile_ael2(), do_parking_thread(), reload_config(), and set_config(). { return __ast_context_create(extcontexts, name, registrar, 0); }

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

Destroy a context (matches the specified context (or ANY context if NULL). Parameters: con  context to destroy registrar  who registered it You can optionally leave out either parameter. It will find it based on either the ast_context or the registrar name. Returns: nothing Definition at line 5259 of file pbx.c. References __ast_context_destroy(). Referenced by cleanup_stale_contexts(), and unload_module(). { __ast_context_destroy(con,registrar); }

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 864 of file pbx.c. References ast_mutex_lock(), ast_mutex_unlock(), and ast_walk_contexts(). Referenced by ast_context_verify_includes(), ast_ignore_pattern(), cleanup_stale_contexts(), do_parking_thread(), park_exec(), register_peer_exten(), reload_config(), and set_config(). { struct ast_context *tmp = NULL; ast_mutex_lock(&conlock); while ( (tmp = ast_walk_contexts(tmp)) ) { if (!name || !strcasecmp(name, tmp->name)) break; } ast_mutex_unlock(&conlock); return tmp; }

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

Register a new context or find an existing one. Parameters: extcontexts  pointer to the ast_context structure pointer name  name of the new context registrar  registrar of the context 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 3806 of file pbx.c. References __ast_context_create(). Referenced by pbx_load_users(). { return __ast_context_create(extcontexts, name, registrar, 1); }

int ast_context_lockmacro (  const char *  context  )

locks the macrolock in the given given context Note: This function locks contexts list by &conlist, searches for the right context structure, and locks the macrolock mutex in that context. macrolock is used to limit a macro to be executed by one call at a time. Definition at line 2767 of file pbx.c. References ast_get_context_name(), ast_lock_contexts(), ast_mutex_lock(), ast_unlock_contexts(), and ast_walk_contexts(). { struct ast_context *c = NULL; int ret = -1; ast_lock_contexts(); while ((c = ast_walk_contexts(c))) { if (!strcmp(ast_get_context_name(c), context)) { ret = 0; break; } } ast_unlock_contexts(); /* if we found context, lock macrolock */ if (ret == 0) ret = ast_mutex_lock(&c->macrolock); return ret; }

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

Simply remove extension from context. Parameters: context  context to remove extension from extension  which extension to remove priority  priority of extension to remove registrar  registrar of the extension This function removes an extension from a given context. Return values: 0  on success -1  on failure Definition at line 2668 of file pbx.c. References ast_context_remove_extension2(), ast_unlock_contexts(), and find_context_locked(). Referenced by handle_context_remove_extension(), and register_peer_exten(). { int ret = -1; /* default error return */ struct ast_context *c = find_context_locked(context); if (c) { /* ... remove extension ... */ ret = ast_context_remove_extension2(c, extension, priority, registrar); ast_unlock_contexts(); } return ret; }

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. 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 2690 of file pbx.c. References ast_mutex_lock(), ast_mutex_unlock(), destroy_exten(), exten, ast_context::lock, ast_exten::next, ast_exten::peer, and ast_context::root. Referenced by ast_context_remove_extension(), do_parking_thread(), and park_exec(). { struct ast_exten *exten, *prev_exten = NULL; struct ast_exten *peer; ast_mutex_lock(&con->lock); /* scan the extension list to find matching extension-registrar */ for (exten = con->root; exten; prev_exten = exten, exten = exten->next) { if (!strcmp(exten->exten, extension) && (!registrar || !strcmp(exten->registrar, registrar))) break; } if (!exten) { /* we can't find right extension */ ast_mutex_unlock(&con->lock); return -1; } /* should we free all peers in this extension? (priority == 0)? */ if (priority == 0) { /* remove this extension from context list */ if (prev_exten) prev_exten->next = exten->next; else con->root = exten->next; /* fire out all peers */ while ( (peer = exten) ) { exten = peer->peer; /* prepare for next entry */ destroy_exten(peer); } } else { /* scan the priority list to remove extension with exten->priority == priority */ struct ast_exten *previous_peer = NULL; for (peer = exten; peer; previous_peer = peer, peer = peer->peer) { if (peer->priority == priority && (!registrar || !strcmp(peer->registrar, registrar) )) break; /* found our priority */ } if (!peer) { /* not found */ ast_mutex_unlock(&con->lock); return -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 (!prev_exten) /* change the root... */ con->root = next_node; else prev_exten->next = next_node; /* unlink */ if (peer->peer) /* XXX 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); /* XXX should we return -1 ? */ } ast_mutex_unlock(&con->lock); return 0; }

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

Definition at line 4341 of file pbx.c. References ast_context_remove_ignorepat2(), ast_unlock_contexts(), and find_context_locked(). Referenced by handle_context_remove_ignorepat(). { int ret = -1; struct ast_context *c = find_context_locked(context); if (c) { ret = ast_context_remove_ignorepat2(c, ignorepat, registrar); ast_unlock_contexts(); } return ret; }

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

Definition at line 4353 of file pbx.c. References ast_mutex_lock(), ast_mutex_unlock(), free, ast_context::ignorepats, ast_context::lock, ast_ignorepat::next, ast_ignorepat::pattern, and ast_ignorepat::registrar. Referenced by ast_context_remove_ignorepat(). { struct ast_ignorepat *ip, *ipl = NULL; ast_mutex_lock(&con->lock); for (ip = con->ignorepats; ip; ip = ip->next) { if (!strcmp(ip->pattern, ignorepat) && (!registrar || (registrar == ip->registrar))) { if (ipl) { ipl->next = ip->next; free(ip); } else { con->ignorepats = ip->next; free(ip); } ast_mutex_unlock(&con->lock); return 0; } ipl = ip; } ast_mutex_unlock(&con->lock); errno = EINVAL; return -1; }

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

Remove a context include. Note: See ast_context_add_include for information on arguments Return values: 0  on success -1  on failure Definition at line 2564 of file pbx.c. References ast_context_remove_include2(), ast_unlock_contexts(), and find_context_locked(). Referenced by handle_context_remove_include(). { int ret = -1; struct ast_context *c = find_context_locked(context); if (c) { /* found, remove include from this context ... */ ret = ast_context_remove_include2(c, include, registrar); ast_unlock_contexts(); } return ret; }

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

Removes an include by an ast_context structure. Note: See ast_context_add_include2 for information on arguments Return values: 0  on success -1  on success Definition at line 2585 of file pbx.c. References ast_mutex_lock(), ast_mutex_unlock(), free, ast_context::includes, ast_context::lock, ast_include::name, ast_include::next, and ast_include::registrar. Referenced by ast_context_remove_include(). { struct ast_include *i, *pi = NULL; int ret = -1; ast_mutex_lock(&con->lock); /* find our include */ for (i = con->includes; i; pi = i, i = i->next) { if (!strcmp(i->name, include) && (!registrar || !strcmp(i->registrar, registrar))) { /* remove from list */ if (pi) pi->next = i->next; else con->includes = i->next; /* free include and return */ free(i); ret = 0; break; } } ast_mutex_unlock(&con->lock); return ret; }

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

Remove a switch. Note: This function locks contexts list by &conlist, search for the rigt context structure, leave context list locked and call ast_context_remove_switch2 which removes switch, unlock contexts list and return ... Definition at line 2617 of file pbx.c. References ast_context_remove_switch2(), ast_unlock_contexts(), and find_context_locked(). { int ret = -1; /* default error return */ struct ast_context *c = find_context_locked(context); if (c) { /* remove switch from this context ... */ ret = ast_context_remove_switch2(c, sw, data, registrar); ast_unlock_contexts(); } return ret; }

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

This function locks given context, removes switch, unlock context and return. Note: When we call this function, &conlock lock must be locked, because when we giving *con argument, some process can remove/change this context and after that there can be segfault. Definition at line 2638 of file pbx.c. References AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_mutex_lock(), ast_mutex_unlock(), ast_sw::data, free, ast_context::lock, ast_sw::name, and ast_sw::registrar. Referenced by ast_context_remove_switch(). { struct ast_sw *i; int ret = -1; ast_mutex_lock(&con->lock); /* walk switches */ AST_LIST_TRAVERSE_SAFE_BEGIN(&con->alts, i, list) { if (!strcmp(i->name, sw) && !strcmp(i->data, data) && (!registrar || !strcmp(i->registrar, registrar))) { /* found, remove from list */ AST_LIST_REMOVE_CURRENT(&con->alts, list); free(i); /* free switch and return */ ret = 0; break; } } AST_LIST_TRAVERSE_SAFE_END ast_mutex_unlock(&con->lock); return ret; }

int ast_context_unlockmacro (  const char *  context  )

Unlocks the macrolock in the given context. Note: This function locks contexts list by &conlist, searches for the right context structure, and unlocks the macrolock mutex in that context. macrolock is used to limit a macro to be executed by one call at a time. Definition at line 2795 of file pbx.c. References ast_get_context_name(), ast_lock_contexts(), ast_mutex_unlock(), ast_unlock_contexts(), and ast_walk_contexts(). { struct ast_context *c = NULL; int ret = -1; ast_lock_contexts(); while ((c = ast_walk_contexts(c))) { if (!strcmp(ast_get_context_name(c), context)) { ret = 0; break; } } ast_unlock_contexts(); /* if we found context, unlock macrolock */ if (ret == 0) ret = ast_mutex_unlock(&c->macrolock); return ret; }

int ast_context_verify_includes (  struct ast_context *  con  )

Verifies includes in an ast_contect structure. Parameters: con  context in which to verify the includes Return values: 0  if no problems found -1  if there were any missing context Definition at line 6146 of file pbx.c. References ast_context_find(), ast_get_context_name(), ast_log(), ast_walk_context_includes(), and ast_include::rname. Referenced by pbx_load_module(). { struct ast_include *inc = NULL; int res = 0; while ( (inc = ast_walk_context_includes(con, inc)) ) if (!ast_context_find(inc->rname)) { res = -1; ast_log(LOG_WARNING, "Context '%s' tries includes nonexistent context '%s'\n", ast_get_context_name(con), inc->rname); } return res; }

struct ast_custom_function* ast_custom_function_find (  const char *  name  )

Definition at line 1319 of file pbx.c. References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, and ast_custom_function::name. Referenced by ast_func_read(), ast_func_write(), and handle_show_function(). { struct ast_custom_function *acf = NULL; AST_RWLIST_RDLOCK(&acf_root); AST_RWLIST_TRAVERSE(&acf_root, acf, acflist) { if (!strcmp(name, acf->name)) break; } AST_RWLIST_UNLOCK(&acf_root); return acf; }

int ast_custom_function_register (  struct ast_custom_function *  acf  )

Reigster a custom function. Definition at line 1355 of file pbx.c. References ast_log(), AST_RWLIST_INSERT_BEFORE_CURRENT, AST_RWLIST_INSERT_TAIL, AST_RWLIST_TRAVERSE, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verbose(), LOG_ERROR, ast_custom_function::name, option_verbose, and VERBOSE_PREFIX_2. Referenced by load_module(). { struct ast_custom_function *cur; if (!acf) return -1; AST_RWLIST_WRLOCK(&acf_root); AST_RWLIST_TRAVERSE(&acf_root, cur, acflist) { if (!strcmp(acf->name, cur->name)) { ast_log(LOG_ERROR, "Function %s already registered.\n", acf->name); AST_RWLIST_UNLOCK(&acf_root); return -1; } } /* Store in alphabetical order */ AST_RWLIST_TRAVERSE_SAFE_BEGIN(&acf_root, cur, acflist) { if (strcasecmp(acf->name, cur->name) < 0) { AST_RWLIST_INSERT_BEFORE_CURRENT(&acf_root, acf, acflist); break; } } AST_RWLIST_TRAVERSE_SAFE_END if (!cur) AST_RWLIST_INSERT_TAIL(&acf_root, acf, acflist); AST_RWLIST_UNLOCK(&acf_root); if (option_verbose > 1) ast_verbose(VERBOSE_PREFIX_2 "Registered custom function %s\n", acf->name); return 0; }

int ast_custom_function_unregister (  struct ast_custom_function *  acf  )

Unregister a custom function. Definition at line 1333 of file pbx.c. References AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verbose(), ast_custom_function::name, option_verbose, and VERBOSE_PREFIX_2. Referenced by unload_module(). { struct ast_custom_function *cur; if (!acf) return -1; AST_RWLIST_WRLOCK(&acf_root); AST_RWLIST_TRAVERSE_SAFE_BEGIN(&acf_root, cur, acflist) { if (cur == acf) { AST_RWLIST_REMOVE_CURRENT(&acf_root, acflist); if (option_verbose > 1) ast_verbose(VERBOSE_PREFIX_2 "Unregistered custom function %s\n", acf->name); break; } } AST_RWLIST_TRAVERSE_SAFE_END AST_RWLIST_UNLOCK(&acf_root); return acf ? 0 : -1; }

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 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 2143 of file pbx.c. References E_MATCH, and pbx_extension_helper(). Referenced by __ast_goto_if_exists(), __ast_pbx_run(), __login_exec(), agentmonitoroutgoing_exec(), answer_call(), ast_park_call(), ast_pbx_outgoing_exten(), builtin_atxfer(), builtin_blindtransfer(), cb_events(), console_dial(), console_transfer(), dp_lookup(), dundi_lookup_local(), get_also_info(), get_destination(), get_refer_info(), handle_stimulus_message(), local_alloc(), local_devicestate(), loopback_exists(), metermaidstate(), mgcp_ss(), misdn_overlap_dial_task(), pbx_builtin_waitexten(), phone_check_exception(), process_ast_dsp(), register_peer_exten(), skinny_ss(), socket_process(), ss_thread(), waitstream_core(), and zt_read(). { return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_MATCH); }

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

Definition at line 4463 of file pbx.c. References AST_FLAG_IN_AUTOLOOP, ast_strlen_zero(), ast_test_flag, ast_channel::context, ast_channel::exten, and ast_channel::priority. Referenced by __ast_goto_if_exists(), ast_async_goto(), ast_parseable_goto(), builtin_atxfer(), and handle_setpriority(). { if (!chan) return -1; if (!ast_strlen_zero(context)) ast_copy_string(chan->context, context, sizeof(chan->context)); if (!ast_strlen_zero(exten)) ast_copy_string(chan->exten, exten, sizeof(chan->exten)); if (priority > -1) { chan->priority = priority; /* see flag description in channel.h for explanation */ if (ast_test_flag(chan, AST_FLAG_IN_AUTOLOOP)) chan->priority--; } return 0; }

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

Definition at line 857 of file pbx.c. References ast_log(), E_CANMATCH, E_MATCHMORE, extension_match_core(), and LOG_WARNING. Referenced by realtime_switch_common(). { if (needmore != E_MATCHMORE && needmore != E_CANMATCH) ast_log(LOG_WARNING, "invalid argument %d\n", needmore); return extension_match_core(pattern, data, needmore); }

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

Determine if a given extension matches a given pattern (in NXX format). Parameters: pattern  pattern to match extension  extension to check against the pattern. Checks whether or not the given extension matches the given pattern. Return values: 1  on match 0  on failure Definition at line 852 of file pbx.c. References E_MATCH, and extension_match_core(). Referenced by ast_ignore_pattern(), loopback_canmatch(), loopback_exec(), loopback_exists(), loopback_matchmore(), manager_show_dialplan_helper(), matchcid(), misdn_cfg_is_msn_valid(), realtime_switch_common(), and show_dialplan_helper(). { return extension_match_core(pattern, data, E_MATCH); }

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

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

Uses hint and devicestate callback to get the state of an extension. Parameters: c  this is not important context  which context to look in exten  which extension to get state Returns: extension state as defined in the ast_extension_states enum Definition at line 1869 of file pbx.c. References ast_extension_state2(), and ast_hint_extension(). Referenced by action_extensionstate(), and handle_request_subscribe(). { struct ast_exten *e; e = ast_hint_extension(c, context, exten); /* Do we have a hint for this extension ? */ if (!e) return -1; /* No hint, return -1 */ return ast_extension_state2(e); /* Check all devices in the hint */ }

const char* ast_extension_state2str (  int  extension_state  )

Return string representation of the state of an extension. Parameters: extension_state  is the numerical state delivered by ast_extension_state Returns: the state of an extension as string Definition at line 1857 of file pbx.c. References extension_states. Referenced by cb_extensionstate(), handle_request_subscribe(), and handle_show_hints(). { int i; for (i = 0; (i < (sizeof(extension_states) / sizeof(extension_states[0]))); i++) { if (extension_states[i].extension_state == extension_state) return extension_states[i].text; } return "Unknown"; }

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

Registers a state change callback. Parameters: context  which context to look in exten  which extension to get state callback  callback to call if state changed data  to pass to callback The callback is called if the state of an extension is changed. Return values: -1  on failure ID  on success Definition at line 1924 of file pbx.c. References AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_state_cb::callback, ast_state_cb::data, ast_state_cb::next, and statecbs. Referenced by handle_request_subscribe(), and init_manager(). { struct ast_hint *hint; struct ast_state_cb *cblist; struct ast_exten *e; /* If there's no context and extension: add callback to statecbs list */ if (!context && !exten) { AST_RWLIST_WRLOCK(&hints); for (cblist = statecbs; cblist; cblist = cblist->next) { if (cblist->callback == callback) { cblist->data = data; AST_RWLIST_UNLOCK(&hints); return 0; } } /* Now insert the callback */ if (!(cblist = ast_calloc(1, sizeof(*cblist)))) { AST_RWLIST_UNLOCK(&hints); return -1; } cblist->id = 0; cblist->callback = callback; cblist->data = data; cblist->next = statecbs; statecbs = cblist; AST_RWLIST_UNLOCK(&hints); 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; } /* Find the hint in the list of hints */ AST_RWLIST_WRLOCK(&hints); AST_RWLIST_TRAVERSE(&hints, hint, list) { if (hint->exten == e) break; } if (!hint) { /* We have no hint, sorry */ AST_RWLIST_UNLOCK(&hints); return -1; } /* Now insert the callback in the callback list */ if (!(cblist = ast_calloc(1, sizeof(*cblist)))) { AST_RWLIST_UNLOCK(&hints); return -1; } cblist->id = stateid++; /* Unique ID for this callback */ cblist->callback = callback; /* Pointer to callback routine */ cblist->data = data; /* Data for the callback */ cblist->next = hint->callbacks; hint->callbacks = cblist; AST_RWLIST_UNLOCK(&hints); return cblist->id; }

int ast_extension_state_del (  int  id, ast_state_cb_type  callback )

Deletes a registered state change callback by ID. Parameters: id  of the callback to delete callback  callback Removes the callback from list of callbacks Return values: 0  success -1  failure Definition at line 1999 of file pbx.c. References AST_RWLIST_WRLOCK, ast_state_cb::next, and statecbs. Referenced by __sip_destroy(). { struct ast_state_cb **p_cur = NULL; /* address of pointer to us */ int ret = -1; if (!id && !callback) return -1; AST_RWLIST_WRLOCK(&hints); if (!id) { /* id == 0 is a callback without extension */ for (p_cur = &statecbs; *p_cur; p_cur = &(*p_cur)->next) { if ((*p_cur)->callback == callback) break; } } else { /* callback with extension, find the callback based on ID */ struct ast_hint *hint; AST_RWLIST_TRAVERSE(&hints, hint, list) { for (p_cur = &hint->callbacks; *p_cur; p_cur = &(*p_cur)->next) { if ((*p_cur)->id == id) break; } if (*p_cur) /* found in the inner loop */ break; } } if (p_cur && *p_cur) { struct ast_state_cb *cur = *p_cur; *p_cur = cur->next; free(cur); ret = 0; } AST_RWLIST_UNLOCK(&hints); return ret; }

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

Find the priority of an extension that has the specified label. Parameters: c  this is not important context  which context to look in exten  which extension to search for label  label of the action within the extension to match to priority callerid  callerid to search for Returns: the priority which matches the given label in the extension or -1 if not found. Definition at line 2148 of file pbx.c. References E_FINDLABEL, and pbx_extension_helper(). Referenced by action_originate(), action_redirect(), ast_parseable_goto(), and handle_setpriority(). { return pbx_extension_helper(c, NULL, context, exten, 0, label, callerid, E_FINDLABEL); }

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: 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 2153 of file pbx.c. References E_FINDLABEL, and pbx_extension_helper(). { return pbx_extension_helper(c, con, NULL, exten, 0, label, callerid, E_FINDLABEL); }

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

executes a read operation on a function Parameters: chan  Channel to execute on function  Data containing the function call string (will be modified) workspace  A pointer to safe memory to use for a return value len  the number of bytes in workspace This application executes a function in read mode on a given channel. Returns: zero on success, non-zero on failure Definition at line 1411 of file pbx.c. References ast_custom_function_find(), ast_log(), ast_strdupa, copy(), func_args(), LOG_ERROR, and ast_custom_function::read. Referenced by action_getvar(), handle_getvariable(), and pbx_substitute_variables_helper_full(). { char *copy = ast_strdupa(function); char *args = func_args(copy); struct ast_custom_function *acfptr = ast_custom_function_find(copy); if (acfptr == NULL) ast_log(LOG_ERROR, "Function %s not registered\n", copy); else if (!acfptr->read) ast_log(LOG_ERROR, "Function %s cannot be read\n", copy); else return acfptr->read(chan, copy, args, workspace, len); return -1; }

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

executes a write operation on a function Parameters: chan  Channel to execute on function  Data containing the function call string (will be modified) value  A value parameter to pass for writing This application executes a function in write mode on a given channel. Returns: zero on success, non-zero on failure Definition at line 1426 of file pbx.c. References ast_custom_function_find(), ast_log(), ast_strdupa, copy(), func_args(), LOG_ERROR, and ast_custom_function::write. Referenced by pbx_builtin_pushvar_helper(), and pbx_builtin_setvar_helper(). { char *copy = ast_strdupa(function); char *args = func_args(copy); struct ast_custom_function *acfptr = ast_custom_function_find(copy); if (acfptr == NULL) ast_log(LOG_ERROR, "Function %s not registered\n", copy); else if (!acfptr->write) ast_log(LOG_ERROR, "Function %s cannot be written to\n", copy); else return acfptr->write(chan, copy, args, value); return -1; }

const char* ast_get_context_name (  struct ast_context *  con  )

Definition at line 6003 of file pbx.c. Referenced by ast_context_add_include2(), ast_context_add_switch2(), ast_context_lockmacro(), ast_context_unlockmacro(), ast_context_verify_includes(), complete_context_add_extension(), complete_context_add_ignorepat(), complete_context_add_include(), complete_context_remove_extension(), complete_context_remove_include(), complete_show_dialplan_context(), dundi_precache_full(), find_context_locked(), handle_save_dialplan(), handle_show_hints(), manager_show_dialplan_helper(), and show_dialplan_helper(). { return con ? con->name : NULL; }

const char* ast_get_context_registrar (  struct ast_context *  c  )

Definition at line 6041 of file pbx.c. References ast_context::registrar. Referenced by handle_save_dialplan(), and show_dialplan_helper(). { return c ? c->registrar : NULL; }

const char* ast_get_extension_app (  struct ast_exten *  e  )

Definition at line 6071 of file pbx.c. References ast_exten::app. Referenced by ast_add_hint(), ast_extension_state2(), ast_get_hint(), ast_hint_state_changed(), handle_save_dialplan(), handle_show_hints(), manager_show_dialplan_helper(), and print_ext(). { return e ? e->app : NULL; }

void* ast_get_extension_app_data (  struct ast_exten *  e  )

Definition at line 6076 of file pbx.c. References ast_exten::data. Referenced by ast_get_hint(), handle_save_dialplan(), manager_show_dialplan_helper(), and print_ext(). { return e ? e->data : NULL; }

const char* ast_get_extension_cidmatch (  struct ast_exten *  e  )

Definition at line 6066 of file pbx.c. References ast_exten::cidmatch. Referenced by handle_save_dialplan(). { return e ? e->cidmatch : NULL; }

struct ast_context* ast_get_extension_context (  struct ast_exten *  exten  )

Definition at line 6008 of file pbx.c. References exten. Referenced by handle_show_hints(). { return exten ? exten->parent : NULL; }

const char* ast_get_extension_label (  struct ast_exten *  e  )

Definition at line 6018 of file pbx.c. References exten. Referenced by handle_save_dialplan(), manager_show_dialplan_helper(), and show_dialplan_helper(). { return exten ? exten->label : NULL; }

int ast_get_extension_matchcid (  struct ast_exten *  e  )

Definition at line 6061 of file pbx.c. References ast_exten::matchcid. Referenced by handle_save_dialplan(). { return e ? e->matchcid : 0; }

const char* ast_get_extension_name (  struct ast_exten *  exten  )

Definition at line 6013 of file pbx.c. References exten. Referenced by ast_add_hint(), complete_context_remove_extension(), dundi_precache_full(), handle_save_dialplan(), handle_show_hints(), manager_show_dialplan_helper(), and show_dialplan_helper(). { return exten ? exten->exten : NULL; }

int ast_get_extension_priority (  struct ast_exten *  exten  )

Definition at line 6033 of file pbx.c. References exten. Referenced by complete_context_remove_extension(), handle_save_dialplan(), manager_show_dialplan_helper(), and print_ext(). { return exten ? exten->priority : -1; }

const char* ast_get_extension_registrar (  struct ast_exten *  e  )

Definition at line 6046 of file pbx.c. References ast_exten::registrar. Referenced by handle_save_dialplan(), manager_show_dialplan_helper(), and show_dialplan_helper(). { return e ? e->registrar : NULL; }

int ast_get_hint (  char *  hint, int  maxlen, char *  name, int  maxnamelen, struct ast_channel *  c, const char *  context, const char *  exten )

If an extension hint exists, return non-zero. Parameters: hint  buffer for hint maxlen  size of hint buffer name  buffer for name portion of hint maxnamelen  size of name buffer c  this is not important context  which context to look in exten  which extension to search for Returns: If an extension within the given context with the priority PRIORITY_HINT is found a non zero value will be returned. Otherwise, 0 is returned. Definition at line 2126 of file pbx.c. References ast_get_extension_app(), ast_get_extension_app_data(), and ast_hint_extension(). Referenced by action_extensionstate(), pbx_retrieve_variable(), and transmit_state_notify(). { struct ast_exten *e = ast_hint_extension(c, context, exten); if (e) { if (hint) ast_copy_string(hint, ast_get_extension_app(e), hintsize); if (name) { const char *tmp = ast_get_extension_app_data(e); if (tmp) ast_copy_string(name, tmp, namesize); } return -1; } return 0; }

const char* ast_get_ignorepat_name (  struct ast_ignorepat *  ip  )

Definition at line 6028 of file pbx.c. References ast_ignorepat::pattern. Referenced by complete_context_remove_ignorepat(), lookup_c_ip(), and manager_show_dialplan_helper(). { return ip ? ip->pattern : NULL; }

const char* ast_get_ignorepat_registrar (  struct ast_ignorepat *  ip  )

Definition at line 6056 of file pbx.c. References ast_ignorepat::registrar. Referenced by manager_show_dialplan_helper(). { return ip ? ip->registrar : NULL; }

const char* ast_get_include_name (  struct ast_include *  include  )

Definition at line 6023 of file pbx.c. References ast_include::name. Referenced by complete_context_remove_include(), lookup_ci(), manager_show_dialplan_helper(), and show_dialplan_helper(). { return inc ? inc->name : NULL; }

const char* ast_get_include_registrar (  struct ast_include *  i  )

Definition at line 6051 of file pbx.c. References ast_include::registrar. Referenced by manager_show_dialplan_helper(). { return i ? i->registrar : NULL; }

const char* ast_get_switch_data (  struct ast_sw *  sw  )

Definition at line 6086 of file pbx.c. References ast_sw::data. Referenced by manager_show_dialplan_helper(). { return sw ? sw->data : NULL; }

const char* ast_get_switch_name (  struct ast_sw *  sw  )

Definition at line 6081 of file pbx.c. References ast_sw::name. Referenced by manager_show_dialplan_helper(). { return sw ? sw->name : NULL; }

const char* ast_get_switch_registrar (  struct ast_sw *  sw  )

Definition at line 6091 of file pbx.c. References ast_sw::registrar. Referenced by manager_show_dialplan_helper(). { return sw ? sw->registrar : NULL; }

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

Definition at line 6180 of file pbx.c. References __ast_goto_if_exists(). { return __ast_goto_if_exists(chan, context, exten, priority, 0); }

void ast_hint_state_changed (  const char *  device  )

Definition at line 1880 of file pbx.c. References ast_extension_state2(), ast_get_extension_app(), AST_MAX_EXTENSION, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_state_cb::callback, ast_hint::callbacks, ast_state_cb::data, ast_exten::exten, ast_hint::exten, ast_hint::laststate, ast_state_cb::next, ast_exten::parent, parse(), statecbs, and strsep(). Referenced by do_state_change(). { struct ast_hint *hint; AST_RWLIST_RDLOCK(&hints); AST_RWLIST_TRAVERSE(&hints, hint, list) { struct ast_state_cb *cblist; char buf[AST_MAX_EXTENSION]; char *parse = buf; char *cur; int state; ast_copy_string(buf, ast_get_extension_app(hint->exten), sizeof(buf)); while ( (cur = strsep(&parse, "&")) ) { if (!strcasecmp(cur, device)) break; } if (!cur) continue; /* Get device state for this hint */ state = ast_extension_state2(hint->exten); if ((state == -1) || (state == hint->laststate)) continue; /* Device state changed since last check - notify the watchers */ /* For general callbacks */ for (cblist = statecbs; cblist; cblist = cblist->next) cblist->callback(hint->exten->parent->name, hint->exten->exten, state, cblist->data); /* For extension callbacks */ for (cblist = hint->callbacks; cblist; cblist = cblist->next) cblist->callback(hint->exten->parent->name, hint->exten->exten, state, cblist->data); hint->laststate = state; /* record we saw the change */ } AST_RWLIST_UNLOCK(&hints); }

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 4429 of file pbx.c. References ast_context_find(), ast_extension_match(), ast_context::ignorepats, ast_ignorepat::next, and ast_ignorepat::pattern. Referenced by ast_app_dtget(), dp_lookup(), dundi_lookup_local(), handle_soft_key_event_message(), handle_stimulus_message(), mgcp_ss(), skinny_ss(), and ss_thread(). { struct ast_context *con = ast_context_find(context); if (con) { struct ast_ignorepat *pat; for (pat = con->ignorepats; pat; pat = pat->next) { if (ast_extension_match(pat->pattern, pattern)) return 1; } } return 0; }

int ast_lock_context (  struct ast_context *  con  )

Locks a given context. Parameters: con  context to lock Return values: 0  on success -1  on failure Definition at line 5990 of file pbx.c. References ast_mutex_lock(), and ast_context::lock. Referenced by complete_context_remove_ignorepat(), complete_context_remove_include(), dundi_precache_full(), handle_save_dialplan(), lookup_c_ip(), lookup_ci(), manager_show_dialplan_helper(), and show_dialplan_helper(). { return ast_mutex_lock(&con->lock); }

int ast_lock_contexts (  void   )

Locks the context list. Return values: 0  on success -1  on error Definition at line 5977 of file pbx.c. References ast_mutex_lock(). Referenced by ast_context_lockmacro(), ast_context_unlockmacro(), complete_context_add_extension(), complete_context_add_ignorepat(), complete_context_add_include(), complete_context_remove_extension(), complete_context_remove_ignorepat(), complete_context_remove_include(), complete_show_dialplan_context(), dundi_precache_full(), find_context_locked(), handle_save_dialplan(), manager_show_dialplan_helper(), show_dialplan_helper(), and unreference_cached_app(). { return ast_mutex_lock(&conlock); }

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 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 2163 of file pbx.c. References E_MATCHMORE, and pbx_extension_helper(). Referenced by ast_app_dtget(), collect_digits(), dp_lookup(), dundi_lookup_local(), handle_stimulus_message(), loopback_matchmore(), mgcp_ss(), skinny_ss(), and ss_thread(). { return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_MATCHMORE); }

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. Parameters: extcontexts  pointer to the ast_context structure pointer 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 3824 of file pbx.c. References __ast_context_destroy(), ast_calloc, AST_EXTENSION_REMOVED, ast_hint_extension(), AST_LIST_HEAD_INIT_VALUE, AST_LIST_INSERT_HEAD, AST_LIST_REMOVE_HEAD, ast_log(), ast_mutex_lock(), ast_mutex_unlock(), AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_state_cb::callback, store_hint::callbacks, ast_hint::callbacks, store_hint::context, contexts, ast_state_cb::data, ast_exten::exten, ast_hint::exten, store_hint::exten, free, ast_hint::laststate, store_hint::laststate, LOG_WARNING, ast_state_cb::next, ast_context::next, ast_exten::parent, and ast_context::registrar. Referenced by pbx_load_module(). { struct ast_context *tmp, *lasttmp = NULL; struct store_hints store = AST_LIST_HEAD_INIT_VALUE; struct store_hint *this; struct ast_hint *hint; struct ast_exten *exten; int length; struct ast_state_cb *thiscb, *prevcb; /* it is very important that this function hold the hint list 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 */ ast_mutex_lock(&conlock); AST_RWLIST_WRLOCK(&hints); /* preserve all watchers for hints associated with this registrar */ AST_RWLIST_TRAVERSE(&hints, hint, list) { if (hint->callbacks && !strcmp(registrar, hint->exten->parent->registrar)) { length = strlen(hint->exten->exten) + strlen(hint->exten->parent->name) + 2 + sizeof(*this); if (!(this = ast_calloc(1, length))) continue; this->callbacks = hint->callbacks; hint->callbacks = NULL; this->laststate = hint->laststate; this->context = this->data; strcpy(this->data, hint->exten->parent->name); this->exten = this->data + strlen(this->context) + 1; strcpy(this->exten, hint->exten->exten); AST_LIST_INSERT_HEAD(&store, this, list); } } tmp = *extcontexts; if (registrar) { /* XXX remove previous contexts from same registrar */ if (option_debug) ast_log(LOG_DEBUG, "must remove any reg %s\n", registrar); __ast_context_destroy(NULL,registrar); while (tmp) { lasttmp = tmp; tmp = tmp->next; } } else { /* XXX remove contexts with the same name */ while (tmp) { ast_log(LOG_WARNING, "must remove %s reg %s\n", tmp->name, tmp->registrar); __ast_context_destroy(tmp,tmp->registrar); lasttmp = tmp; tmp = tmp->next; } } if (lasttmp) { lasttmp->next = contexts; contexts = *extcontexts; *extcontexts = NULL; } else ast_log(LOG_WARNING, "Requested contexts didn't get merged\n"); /* restore the watchers for hints that can be found; notify those that cannot be restored */ while ((this = AST_LIST_REMOVE_HEAD(&store, list))) { exten = ast_hint_extension(NULL, this->context, this->exten); /* Find the hint in the list of hints */ AST_RWLIST_TRAVERSE(&hints, hint, list) { if (hint->exten == exten) break; } if (!exten || !hint) { /* this hint has been removed, notify the watchers */ prevcb = NULL; thiscb = this->callbacks; while (thiscb) { prevcb = thiscb; thiscb = thiscb->next; prevcb->callback(this->context, this->exten, AST_EXTENSION_REMOVED, prevcb->data); free(prevcb); } } else { thiscb = this->callbacks; while (thiscb->next) thiscb = thiscb->next; thiscb->next = hint->callbacks; hint->callbacks = this->callbacks; hint->laststate = this->laststate; } free(this); } AST_RWLIST_UNLOCK(&hints); ast_mutex_unlock(&conlock); return; }

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

Definition at line 6190 of file pbx.c. References ast_cdr_update(), ast_explicit_goto(), ast_findlabel_extension(), ast_log(), ast_strdupa, ast_strlen_zero(), ast_channel::cid, ast_callerid::cid_num, ast_channel::context, ast_channel::exten, exten, ast_channel::priority, and strsep(). Referenced by ivr_dispatch(), and pbx_builtin_goto(). { char *exten, *pri, *context; char *stringp; int ipri; int mode = 0; if (ast_strlen_zero(goto_string)) { ast_log(LOG_WARNING, "Goto requires an argument (optional context|optional 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, "%d", &ipri) != 1) { if ((ipri = ast_findlabel_extension(chan, context ? context : chan->context, exten ? exten : chan->exten, pri, chan->cid.cid_num)) < 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 = chan->priority + (ipri * mode); ast_explicit_goto(chan, context, exten, ipri); ast_cdr_update(chan); return 0; }

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 )

Synchronously or asynchronously make an outbound call and send it to a particular application with given extension Definition at line 5055 of file pbx.c. References __ast_request_and_dial(), ast_calloc, ast_cdr_alloc(), ast_cdr_disposition(), ast_cdr_failed(), ast_cdr_init(), ast_cdr_setaccount(), ast_cdr_start(), ast_channel_lock, ast_channel_unlock, ast_hangup(), ast_log(), ast_pbx_outgoing_cdr_failed(), ast_pbx_run_app(), ast_pthread_create, ast_set_variables(), AST_STATE_UP, ast_strlen_zero(), ast_variables_destroy(), ast_verbose(), async_wait(), ast_channel::cdr, async_stat::chan, free, option_verbose, ast_channel::pbx, outgoing_helper::vars, and VERBOSE_PREFIX_4. Referenced by action_originate(), attempt_thread(), fast_originate(), and orig_app(). { struct ast_channel *chan; struct app_tmp *tmp; int res = -1, cdr_res = -1; struct outgoing_helper oh; pthread_attr_t attr; memset(&oh, 0, sizeof(oh)); oh.vars = vars; oh.account = account; if (locked_channel) *locked_channel = NULL; if (ast_strlen_zero(app)) { res = -1; goto outgoing_app_cleanup; } if (sync) { chan = __ast_request_and_dial(type, format, data, timeout, reason, cid_num, cid_name, &oh); if (chan) { if (chan->cdr) { /* check if the channel already has a cdr record, if not give it one */ ast_log(LOG_WARNING, "%s already has a call record??\n", chan->name); } else { chan->cdr = ast_cdr_alloc(); /* allocate a cdr for the channel */ if (!chan->cdr) { /* allocation of the cdr failed */ free(chan->pbx); res = -1; goto outgoing_app_cleanup; } /* allocation of the cdr was successful */ ast_cdr_init(chan->cdr, chan); /* initialize our channel's cdr */ ast_cdr_start(chan->cdr); } ast_set_variables(chan, vars); if (account) ast_cdr_setaccount(chan, account); if (chan->_state == AST_STATE_UP) { res = 0; if (option_verbose > 3) ast_verbose(VERBOSE_PREFIX_4 "Channel %s was answered.\n", chan->name); tmp = ast_calloc(1, sizeof(*tmp)); if (!tmp) res = -1; else { ast_copy_string(tmp->app, app, sizeof(tmp->app)); if (appdata) ast_copy_string(tmp->data, appdata, sizeof(tmp->data)); tmp->chan = chan; if (sync > 1) { if (locked_channel) ast_channel_unlock(chan); ast_pbx_run_app(tmp); } else { pthread_attr_init(&attr); pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED); if (locked_channel) ast_channel_lock(chan); if (ast_pthread_create(&tmp->t, &attr, ast_pbx_run_app, tmp)) { ast_log(LOG_WARNING, "Unable to spawn execute thread on %s: %s\n", chan->name, strerror(errno)); free(tmp); if (locked_channel) ast_channel_unlock(chan); ast_hangup(chan); res = -1; } else { if (locked_channel) *locked_channel = chan; } pthread_attr_destroy(&attr); } } } else { if (option_verbose > 3) ast_verbose(VERBOSE_PREFIX_4 "Channel %s was never answered.\n", chan->name); if (chan->cdr) { /* update the cdr */ /* here we update the status of the call, which sould be busy. * if that fails then we set the status to failed */ if (ast_cdr_disposition(chan->cdr, chan->hangupcause)) ast_cdr_failed(chan->cdr); } ast_hangup(chan); } } if (res < 0) { /* the call failed for some reason */ if (*reason == 0) { /* if the call failed (not busy or no answer) * update the cdr with the failed message */ cdr_res = ast_pbx_outgoing_cdr_failed(); if (cdr_res != 0) { res = cdr_res; goto outgoing_app_cleanup; } } } } else { struct async_stat *as; if (!(as = ast_calloc(1, sizeof(*as)))) { res = -1; goto outgoing_app_cleanup; } chan = __ast_request_and_dial(type, format, data, timeout, reason, cid_num, cid_name, &oh); if (!chan) { free(as); res = -1; goto outgoing_app_cleanup; } as->chan = chan; ast_copy_string(as->app, app, sizeof(as->app)); if (appdata) ast_copy_string(as->appdata, appdata, sizeof(as->appdata)); as->timeout = timeout; ast_set_variables(chan, vars); if (account) ast_cdr_setaccount(chan, account); /* Start a new thread, and get something handling this channel. */ pthread_attr_init(&attr); pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED); if (locked_channel) ast_channel_lock(chan); if (ast_pthread_create(&as->p, &attr, async_wait, as)) { ast_log(LOG_WARNING, "Failed to start async wait\n"); free(as); if (locked_channel) ast_channel_unlock(chan); ast_hangup(chan); res = -1; pthread_attr_destroy(&attr); goto outgoing_app_cleanup; } else { if (locked_channel) *locked_channel = chan; } pthread_attr_destroy(&attr); res = 0; } outgoing_app_cleanup: ast_variables_destroy(vars); return res; }

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 **  locked_channel )

Synchronously or asynchronously make an outbound call and send it to a particular extension Definition at line 4877 of file pbx.c. References __ast_request_and_dial(), ast_channel::_state, outgoing_helper::account, ast_calloc, ast_cdr_alloc(), ast_cdr_disposition(), ast_cdr_failed(), ast_cdr_init(), ast_cdr_setaccount(), ast_cdr_start(), ast_channel_alloc(), ast_channel_lock, ast_channel_unlock, ast_exists_extension(), ast_hangup(), ast_log(), ast_pbx_outgoing_cdr_failed(), ast_pbx_run(), ast_pbx_start(), ast_pthread_create, ast_request_and_dial(), ast_set_variables(), AST_STATE_DOWN, AST_STATE_UP, ast_strlen_zero(), ast_variables_destroy(), ast_verbose(), async_wait(), ast_channel::cdr, outgoing_helper::cid_name, outgoing_helper::cid_num, ast_channel::context, outgoing_helper::context, outgoing_helper::exten, free, ast_channel::hangupcause, LOG_ERROR, option_verbose, outgoing_helper::parent_channel, ast_channel::pbx, outgoing_helper::priority, set_ext_pri(), outgoing_helper::vars, and VERBOSE_PREFIX_4. Referenced by action_originate(), attempt_thread(), fast_originate(), and orig_exten(). { struct ast_channel *chan; struct async_stat *as; int res = -1, cdr_res = -1; struct outgoing_helper oh; pthread_attr_t attr; if (sync) { oh.context = context; oh.exten = exten; oh.priority = priority; oh.cid_num = cid_num; oh.cid_name = cid_name; oh.account = account; oh.vars = vars; oh.parent_channel = NULL; chan = __ast_request_and_dial(type, format, data, timeout, reason, cid_num, cid_name, &oh); if (channel) { *channel = chan; if (chan) ast_channel_lock(chan); } if (chan) { if (chan->cdr) { /* check if the channel already has a cdr record, if not give it one */ ast_log(LOG_WARNING, "%s already has a call record??\n", chan->name); } else { chan->cdr = ast_cdr_alloc(); /* allocate a cdr for the channel */ if (!chan->cdr) { /* allocation of the cdr failed */ free(chan->pbx); res = -1; goto outgoing_exten_cleanup; } /* allocation of the cdr was successful */ ast_cdr_init(chan->cdr, chan); /* initialize our channel's cdr */ ast_cdr_start(chan->cdr); } if (chan->_state == AST_STATE_UP) { res = 0; if (option_verbose > 3) ast_verbose(VERBOSE_PREFIX_4 "Channel %s was answered.\n", chan->name); if (sync > 1) { if (channel) ast_channel_unlock(chan); if (ast_pbx_run(chan)) { ast_log(LOG_ERROR, "Unable to run PBX on %s\n", chan->name); if (channel) *channel = NULL; ast_hangup(chan); res = -1; } } else { if (ast_pbx_start(chan)) { ast_log(LOG_ERROR, "Unable to start PBX on %s\n", chan->name); if (channel) { *channel = NULL; ast_channel_unlock(chan); } ast_hangup(chan); res = -1; } } } else { if (option_verbose > 3) ast_verbose(VERBOSE_PREFIX_4 "Channel %s was never answered.\n", chan->name); if (chan->cdr) { /* update the cdr */ /* here we update the status of the call, which sould be busy. * if that fails then we set the status to failed */ if (ast_cdr_disposition(chan->cdr, chan->hangupcause)) ast_cdr_failed(chan->cdr); } if (channel) { *channel = NULL; ast_channel_unlock(chan); } ast_hangup(chan); } } if (res < 0) { /* the call failed for some reason */ if (*reason == 0) { /* if the call failed (not busy or no answer) * update the cdr with the failed message */ cdr_res = ast_pbx_outgoing_cdr_failed(); if (cdr_res != 0) { res = cdr_res; goto outgoing_exten_cleanup; } } /* create a fake channel and execute the "failed" extension (if it exists) within the requested context */ /* check if "failed" exists */ if (ast_exists_extension(chan, context, "failed", 1, NULL)) { chan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "OutgoingSpoolFailed"); if (chan) { if (!ast_strlen_zero(context)) ast_copy_string(chan->context, context, sizeof(chan->context)); set_ext_pri(chan, "failed", 1); ast_set_variables(chan, vars); if (account) ast_cdr_setaccount(chan, account); ast_pbx_run(chan); } } } } else { if (!(as = ast_calloc(1, sizeof(*as)))) { res = -1; goto outgoing_exten_cleanup; } chan = ast_request_and_dial(type, format, data, timeout, reason, cid_num, cid_name); if (channel) { *channel = chan; if (chan) ast_channel_lock(chan); } if (!chan) { free(as); res = -1; goto outgoing_exten_cleanup; } as->chan = chan; ast_copy_string(as->context, context, sizeof(as->context)); set_ext_pri(as->chan, exten, priority); as->timeout = timeout; ast_set_variables(chan, vars); if (account) ast_cdr_setaccount(chan, account); pthread_attr_init(&attr); pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED); if (ast_pthread_create(&as->p, &attr, async_wait, as)) { ast_log(LOG_WARNING, "Failed to start async wait\n"); free(as); if (channel) { *channel = NULL; ast_channel_unlock(chan); } ast_hangup(chan); res = -1; pthread_attr_destroy(&attr); goto outgoing_exten_cleanup; } pthread_attr_destroy(&attr); res = 0; } outgoing_exten_cleanup: ast_variables_destroy(vars); return res; }

enum ast_pbx_result ast_pbx_run (  struct ast_channel *  c  )

Execute the PBX in the current thread. Parameters: c  channel to run the pbx on This executes the PBX on a given channel. It allocates a new PBX structure for the channel, and provides all PBX functionality. See ast_pbx_start for an asynchronous function to run the PBX in a new thread as opposed to the current one. Returns: Zero on success, non-zero on failure Definition at line 2517 of file pbx.c. References __ast_pbx_run(), AST_PBX_CALL_LIMIT, AST_PBX_SUCCESS, decrease_call_count(), and increase_call_count(). Referenced by ast_pbx_outgoing_exten(), async_wait(), mgcp_ss(), skinny_newcall(), and ss_thread(). { enum ast_pbx_result res = AST_PBX_SUCCESS; if (increase_call_count(c)) return AST_PBX_CALL_LIMIT; res = __ast_pbx_run(c); decrease_call_count(); return res; }

enum ast_pbx_result ast_pbx_start (  struct ast_channel *  c  )

Create a new thread and start the PBX. Parameters: c  channel to start the pbx on See ast_pbx_run for a synchronous function to run the PBX in the current thread, as opposed to starting a new one. Returns: Zero on success, non-zero on failure Definition at line 2491 of file pbx.c. References ast_log(), AST_PBX_CALL_LIMIT, AST_PBX_FAILED, AST_PBX_SUCCESS, ast_pthread_create, increase_call_count(), LOG_WARNING, and pbx_thread(). Referenced by __oh323_new(), alsa_new(), ast_async_goto(), ast_iax2_new(), ast_pbx_outgoing_exten(), do_parking_thread(), gtalk_new(), gtalk_newcall(), handle_request_invite(), jingle_new(), jingle_newcall(), local_call(), mgcp_new(), nbs_new(), oss_new(), pbx_start_chan(), phone_new(), sip_new(), and skinny_new(). { pthread_t t; pthread_attr_t attr; if (!c) { ast_log(LOG_WARNING, "Asked to start thread on NULL channel?\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. */ pthread_attr_init(&attr); pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED); if (ast_pthread_create(&t, &attr, pbx_thread, c)) { ast_log(LOG_WARNING, "Failed to create new channel thread\n"); pthread_attr_destroy(&attr); return AST_PBX_FAILED; } pthread_attr_destroy(&attr); return AST_PBX_SUCCESS; }

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

Register an application. Parameters: app  Short name of the application execute  a function callback to execute the application. It should return non-zero if the channel needs to be hung up. synopsis  a short description (one line synopsis) of the application description  long description with all of the details about the use of the application This registers an application with Asterisk's internal application list. Note: The individual applications themselves are responsible for registering and unregistering and unregistering their own CLI commands. Return values: 0  success -1  failure. Definition at line 2819 of file pbx.c. References ast_calloc, ast_log(), AST_RWLIST_INSERT_BEFORE_CURRENT, AST_RWLIST_INSERT_TAIL, AST_RWLIST_TRAVERSE, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verbose(), COLOR_BRCYAN, ast_app::description, ast_app::execute, LOG_WARNING, option_verbose, ast_app::synopsis, term_color(), and VERBOSE_PREFIX_2. Referenced by load_module(), and load_pbx(). { struct ast_app *tmp, *cur = NULL; char tmps[80]; int length; AST_RWLIST_WRLOCK(&apps); AST_RWLIST_TRAVERSE(&apps, tmp, list) { if (!strcasecmp(app, tmp->name)) { ast_log(LOG_WARNING, "Already have an application '%s'\n", app); AST_RWLIST_UNLOCK(&apps); return -1; } } length = sizeof(*tmp) + strlen(app) + 1; if (!(tmp = ast_calloc(1, length))) { AST_RWLIST_UNLOCK(&apps); return -1; } strcpy(tmp->name, app); tmp->execute = execute; tmp->synopsis = synopsis; tmp->description = description; /* Store in alphabetical order */ AST_RWLIST_TRAVERSE_SAFE_BEGIN(&apps, cur, list) { if (strcasecmp(tmp->name, cur->name) < 0) { AST_RWLIST_INSERT_BEFORE_CURRENT(&apps, tmp, list); break; } } AST_RWLIST_TRAVERSE_SAFE_END if (!cur) AST_RWLIST_INSERT_TAIL(&apps, tmp, list); if (option_verbose > 1) ast_verbose( VERBOSE_PREFIX_2 "Registered application '%s'\n", term_color(tmps, tmp->name, COLOR_BRCYAN, 0, sizeof(tmps))); AST_RWLIST_UNLOCK(&apps); return 0; }

int ast_register_switch (  struct ast_switch *  sw  )

Register an alternative dialplan switch. Parameters: sw  switch to register This function registers a populated ast_switch structure with the asterisk switching architecture. Returns: 0 on success, and other than 0 on failure Definition at line 2869 of file pbx.c. References ast_log(), AST_RWLIST_INSERT_TAIL, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, LOG_WARNING, and ast_switch::name. Referenced by load_module(). { struct ast_switch *tmp; AST_RWLIST_WRLOCK(&switches); AST_RWLIST_TRAVERSE(&switches, tmp, list) { if (!strcasecmp(tmp->name, sw->name)) { AST_RWLIST_UNLOCK(&switches); ast_log(LOG_WARNING, "Switch '%s' already found\n", sw->name); return -1; } } AST_RWLIST_INSERT_TAIL(&switches, sw, list); AST_RWLIST_UNLOCK(&switches); return 0; }

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). 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 This adds a new extension to the asterisk extension list. Return values: 0  on success -1  on failure. Definition at line 2168 of file pbx.c. References E_SPAWN, and pbx_extension_helper(). Referenced by __ast_pbx_run(), and loopback_exec(). { return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_SPAWN); }

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 5995 of file pbx.c. References ast_mutex_unlock(), and ast_context::lock. Referenced by complete_context_remove_ignorepat(), complete_context_remove_include(), dundi_precache_full(), lookup_c_ip(), lookup_ci(), and manager_show_dialplan_helper(). { return ast_mutex_unlock(&con->lock); }

int ast_unlock_contexts (  void   )

Unlocks contexts. Return values: 0  on success -1  on failure Definition at line 5982 of file pbx.c. References ast_mutex_unlock(). Referenced by ast_add_extension(), ast_context_add_ignorepat(), ast_context_add_include(), ast_context_add_switch(), ast_context_lockmacro(), ast_context_remove_extension(), ast_context_remove_ignorepat(), ast_context_remove_include(), ast_context_remove_switch(), ast_context_unlockmacro(), complete_context_add_extension(), complete_context_add_ignorepat(), complete_context_add_include(), complete_context_remove_extension(), complete_context_remove_include(), complete_show_dialplan_context(), dundi_precache_full(), find_context_locked(), handle_save_dialplan(), manager_show_dialplan_helper(), and unreference_cached_app(). { return ast_mutex_unlock(&conlock); }

int ast_unregister_application (  const char *  app  )

Unregister an application. Parameters: app  name of the application (does not have to be the same string as the one that was registered) This unregisters an application from Asterisk's internal application list. Return values: 0  success -1  failure Definition at line 3737 of file pbx.c. References AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verbose(), free, option_verbose, unreference_cached_app(), and VERBOSE_PREFIX_2. Referenced by __unload_module(), and unload_module(). { struct ast_app *tmp; AST_RWLIST_WRLOCK(&apps); AST_RWLIST_TRAVERSE_SAFE_BEGIN(&apps, tmp, list) { if (!strcasecmp(app, tmp->name)) { unreference_cached_app(tmp); AST_RWLIST_REMOVE_CURRENT(&apps, list); if (option_verbose > 1) ast_verbose( VERBOSE_PREFIX_2 "Unregistered application '%s'\n", tmp->name); free(tmp); break; } } AST_RWLIST_TRAVERSE_SAFE_END AST_RWLIST_UNLOCK(&apps); return tmp ? 0 : -1; }

void ast_unregister_switch (  struct ast_switch *  sw  )

Unregister an alternative switch. Parameters: sw  switch to unregister Unregisters a switch from asterisk. Returns: nothing Definition at line 2887 of file pbx.c. References AST_RWLIST_REMOVE, AST_RWLIST_UNLOCK, and AST_RWLIST_WRLOCK. Referenced by __unload_module(), and unload_module(). { AST_RWLIST_WRLOCK(&switches); AST_RWLIST_REMOVE(&switches, sw, list); AST_RWLIST_UNLOCK(&switches); }

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

Definition at line 6104 of file pbx.c. References exten, and ast_context::root. Referenced by complete_context_remove_extension(), dundi_precache_full(), handle_save_dialplan(), manager_show_dialplan_helper(), show_dialplan_helper(), and unreference_cached_app(). { if (!exten) return con ? con->root : NULL; else return exten->next; }

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

Definition at line 6137 of file pbx.c. References ast_context::ignorepats, and ast_ignorepat::next. Referenced by complete_context_remove_ignorepat(), lookup_c_ip(), and manager_show_dialplan_helper(). { if (!ip) return con ? con->ignorepats : NULL; else return ip->next; }

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

Definition at line 6128 of file pbx.c. References ast_context::includes, and ast_include::next. Referenced by ast_context_verify_includes(), complete_context_remove_include(), lookup_ci(), manager_show_dialplan_helper(), and show_dialplan_helper(). { if (!inc) return con ? con->includes : NULL; else return inc->next; }

struct ast_sw* ast_walk_context_switches (  struct ast_context *  con,