move the definition of the mappings between extension states and their text
[asterisk/asterisk.git] / include / asterisk / pbx.h
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2006, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  * \brief Core PBX routines and definitions.
21  */
22
23 #ifndef _ASTERISK_PBX_H
24 #define _ASTERISK_PBX_H
25
26 #include "asterisk/sched.h"
27 #include "asterisk/channel.h"
28
29 #if defined(__cplusplus) || defined(c_plusplus)
30 extern "C" {
31 #endif
32
33 #define AST_PBX_KEEP    0
34 #define AST_PBX_REPLACE 1
35
36 /*! Max length of an application */
37 #define AST_MAX_APP     32
38
39 /*! Special return values from applications to the PBX */
40 #define AST_PBX_KEEPALIVE       10              /* Destroy the thread, but don't hang up the channel */
41 #define AST_PBX_NO_HANGUP_PEER       11
42
43 /*! Special Priority for an hint */
44 #define PRIORITY_HINT   -1
45
46 /*! Extension states */
47 enum ast_extension_states {
48         /*! Extension removed */
49         AST_EXTENSION_REMOVED = -2,
50         /*! Extension hint removed */
51         AST_EXTENSION_DEACTIVATED = -1,
52         /*! No device INUSE or BUSY  */
53         AST_EXTENSION_NOT_INUSE = 0,
54         /*! One or more devices INUSE */
55         AST_EXTENSION_INUSE = 1 << 0,
56         /*! All devices BUSY */
57         AST_EXTENSION_BUSY = 1 << 1,
58         /*! All devices UNAVAILABLE/UNREGISTERED */
59         AST_EXTENSION_UNAVAILABLE = 1 << 2,
60         /*! All devices RINGING */
61         AST_EXTENSION_RINGING = 1 << 3,
62 };
63
64
65 struct ast_context;
66 struct ast_exten;     
67 struct ast_include;
68 struct ast_ignorepat;
69 struct ast_sw;
70
71 typedef int (*ast_state_cb_type)(char *context, char* id, enum ast_extension_states state, void *data);
72
73 /*! Data structure associated with a custom function */
74 struct ast_custom_function {
75         char *name;
76         char *synopsis;
77         char *desc;
78         char *syntax;
79         int (*read)(struct ast_channel *, char *, char *, char *, size_t);
80         int (*write)(struct ast_channel *, char *, char *, const char *);
81         struct ast_custom_function *next;
82 };
83
84 /*! Data structure associated with an asterisk switch */
85 struct ast_switch {
86         /*! NULL */
87         struct ast_switch *next;        
88         /*! Name of the switch */
89         const char *name;                               
90         /*! Description of the switch */
91         const char *description;                
92         
93         int (*exists)(struct ast_channel *chan, const char *context, const char *exten, int priority, const char *callerid, const char *data);
94         
95         int (*canmatch)(struct ast_channel *chan, const char *context, const char *exten, int priority, const char *callerid, const char *data);
96         
97         int (*exec)(struct ast_channel *chan, const char *context, const char *exten, int priority, const char *callerid, int newstack, const char *data);
98
99         int (*matchmore)(struct ast_channel *chan, const char *context, const char *exten, int priority, const char *callerid, const char *data);
100 };
101
102 struct ast_timing {
103         int hastime;                            /* If time construct exists */
104         unsigned int monthmask;                 /* Mask for month */
105         unsigned int daymask;                   /* Mask for date */
106         unsigned int dowmask;                   /* Mask for day of week (mon-sun) */
107         unsigned int minmask[24];               /* Mask for minute */
108 };
109
110 extern int ast_build_timing(struct ast_timing *i, char *info);
111 extern int ast_check_timing(struct ast_timing *i);
112
113 struct ast_pbx {
114         int dtimeout;                                   /* Timeout between digits (seconds) */
115         int rtimeout;                                   /* Timeout for response
116                                                            (seconds) */
117 };
118
119
120 /*! Register an alternative switch */
121 /*!
122  * \param sw switch to register
123  * This function registers a populated ast_switch structure with the
124  * asterisk switching architecture.
125  * It returns 0 on success, and other than 0 on failure
126  */
127 extern int ast_register_switch(struct ast_switch *sw);
128
129 /*! Unregister an alternative switch */
130 /*!
131  * \param sw switch to unregister
132  * Unregisters a switch from asterisk.
133  * Returns nothing
134  */
135 extern void ast_unregister_switch(struct ast_switch *sw);
136
137 /*! Look up an application */
138 /*!
139  * \param app name of the app
140  * This function searches for the ast_app structure within
141  * the apps that are registered for the one with the name
142  * you passed in.
143  * Returns the ast_app structure that matches on success, or NULL on failure
144  */
145 extern struct ast_app *pbx_findapp(const char *app);
146
147 /*! executes an application */
148 /*!
149  * \param c channel to execute on
150  * \param app which app to execute
151  * \param data the data passed into the app
152  * \param newstack stack pointer
153  * This application executes an application on a given channel.  It
154  * saves the stack and executes the given appliation passing in
155  * the given data.
156  * It returns 0 on success, and -1 on failure
157  */
158 int pbx_exec(struct ast_channel *c, struct ast_app *app, void *data, int newstack);
159
160 /*! Register a new context */
161 /*!
162  * \param extcontexts pointer to the ast_context structure pointer
163  * \param name name of the new context
164  * \param registrar registrar of the context
165  * This will first search for a context with your name.  If it exists already, it will not
166  * create a new one.  If it does not exist, it will create a new one with the given name
167  * and registrar.
168  * It returns NULL on failure, and an ast_context structure on success
169  */
170 struct ast_context *ast_context_create(struct ast_context **extcontexts, const char *name, const char *registrar);
171
172 /*! Merge the temporary contexts into a global contexts list and delete from the global list the ones that are being added */
173 /*!
174  * \param extcontexts pointer to the ast_context structure pointer
175  * \param 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
176  */
177 void ast_merge_contexts_and_delete(struct ast_context **extcontexts, const char *registrar);
178
179 /*! Destroy a context (matches the specified context (or ANY context if NULL) */
180 /*!
181  * \param con context to destroy
182  * \param registrar who registered it
183  * You can optionally leave out either parameter.  It will find it
184  * based on either the ast_context or the registrar name.
185  * Returns nothing
186  */
187 void ast_context_destroy(struct ast_context *con, const char *registrar);
188
189 /*! Find a context */
190 /*!
191  * \param name name of the context to find
192  * Will search for the context with the given name.
193  * Returns the ast_context on success, NULL on failure.
194  */
195 struct ast_context *ast_context_find(const char *name);
196
197 enum ast_pbx_result {
198         AST_PBX_SUCCESS = 0,
199         AST_PBX_FAILED = -1,
200         AST_PBX_CALL_LIMIT = -2,
201 };
202
203 /*! Create a new thread and start the PBX (or whatever) */
204 /*!
205  * \param c channel to start the pbx on
206  * \return Zero on success, non-zero on failure
207  */
208 enum ast_pbx_result ast_pbx_start(struct ast_channel *c);
209
210 /*! Execute the PBX in the current thread */
211 /*!
212  * \param c channel to run the pbx on
213  * \return Zero on success, non-zero on failure
214  * This executes the PBX on a given channel. It allocates a new
215  * PBX structure for the channel, and provides all PBX functionality.
216  */
217 enum ast_pbx_result ast_pbx_run(struct ast_channel *c);
218
219 /*! 
220  * \param context context to add the extension to
221  * \param replace
222  * \param extension extension to add
223  * \param priority priority level of extension addition
224  * \param label extension label
225  * \param callerid callerid of extension
226  * \param application application to run on the extension with that priority level
227  * \param data data to pass to the application
228  * \param datad
229  * \param registrar who registered the extension
230  * Add and extension to an extension context.  
231  * Callerid is a pattern to match CallerID, or NULL to match any callerid
232  * Returns 0 on success, -1 on failure
233  */
234 int ast_add_extension(const char *context, int replace, const char *extension, int priority, const char *label, const char *callerid,
235         const char *application, void *data, void (*datad)(void *), const char *registrar);
236
237 /*! Add an extension to an extension context, this time with an ast_context *.  CallerID is a pattern to match on callerid, or NULL to not care about callerid */
238 /*! 
239  * For details about the arguements, check ast_add_extension()
240  */
241 int ast_add_extension2(struct ast_context *con,
242                                       int replace, const char *extension, int priority, const char *label, const char *callerid, 
243                                           const char *application, void *data, void (*datad)(void *),
244                                           const char *registrar);
245
246 /*! Add an application.  The function 'execute' should return non-zero if the line needs to be hung up.  */
247 /*!
248   \param app Short name of the application
249   \param execute a function callback to execute the application
250   \param synopsis a short description of the application
251   \param description long description of the application
252    Include a one-line synopsis (e.g. 'hangs up a channel') and a more lengthy, multiline
253    description with more detail, including under what conditions the application
254    will return 0 or -1.
255    This registers an application with asterisks internal application list.  Please note:
256    The individual applications themselves are responsible for registering and unregistering
257    CLI commands.
258    It returns 0 on success, -1 on failure.
259 */
260 int ast_register_application(const char *app, int (*execute)(struct ast_channel *, void *),
261                              const char *synopsis, const char *description);
262
263 /*! Remove an application */
264 /*!
265  * \param app name of the application (does not have to be the same string as the one that was registered)
266  * This unregisters an application from asterisk's internal registration mechanisms.
267  * It returns 0 on success, and -1 on failure.
268  */
269 int ast_unregister_application(const char *app);
270
271 /*! Uses hint and devicestate callback to get the state of an extension */
272 /*!
273  * \param c this is not important
274  * \param context which context to look in
275  * \param exten which extension to get state
276  * Returns extension state !! = AST_EXTENSION_???
277  */
278 int ast_extension_state(struct ast_channel *c, const char *context, const char *exten);
279
280 /*! Return string of the state of an extension */
281 /*!
282  * \param extension_state is the numerical state delivered by ast_extension_state
283  * Returns the state of an extension as string
284  */
285 const char *ast_extension_state2str(int extension_state);
286
287 /*! Registers a state change callback */
288 /*!
289  * \param context which context to look in
290  * \param exten which extension to get state
291  * \param callback callback to call if state changed
292  * \param data to pass to callback
293  * The callback is called if the state for extension is changed
294  * Return -1 on failure, ID on success
295  */ 
296 int ast_extension_state_add(const char *context, const char *exten, 
297                             ast_state_cb_type callback, void *data);
298
299 /*! Deletes a registered state change callback by ID */
300 /*!
301  * \param id of the callback to delete
302  * \param callback callback
303  * Removes the callback from list of callbacks
304  * Return 0 on success, -1 on failure
305  */
306 int ast_extension_state_del(int id, ast_state_cb_type callback);
307
308 /*! If an extension exists, return non-zero */
309 /*!
310  * \param hint buffer for hint
311  * \param maxlen size of hint buffer
312  * \param name buffer for name portion of hint
313  * \param maxnamelen size of name buffer
314  * \param c this is not important
315  * \param context which context to look in
316  * \param exten which extension to search for
317  * If an extension within the given context with the priority PRIORITY_HINT
318  * is found a non zero value will be returned.
319  * Otherwise, 0 is returned.
320  */
321 int ast_get_hint(char *hint, int maxlen, char *name, int maxnamelen, struct ast_channel *c, const char *context, const char *exten);
322
323 /*! If an extension exists, return non-zero */
324 /*  work */
325 /*!
326  * \param c this is not important
327  * \param context which context to look in
328  * \param exten which extension to search for
329  * \param priority priority of the action within the extension
330  * \param callerid callerid to search for
331  * If an extension within the given context(or callerid) with the given priority is found a non zero value will be returned.
332  * Otherwise, 0 is returned.
333  */
334 int ast_exists_extension(struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid);
335
336 /*! If an extension exists, return non-zero */
337 /*  work */
338 /*!
339  * \param c this is not important
340  * \param context which context to look in
341  * \param exten which extension to search for
342  * \param label label of the action within the extension to match to priority
343  * \param callerid callerid to search for
344  * If an priority which matches given label in extension or -1 if not found.
345 \ */
346 int ast_findlabel_extension(struct ast_channel *c, const char *context, const char *exten, const char *label, const char *callerid);
347
348 int ast_findlabel_extension2(struct ast_channel *c, struct ast_context *con, const char *exten, const char *label, const char *callerid);
349
350 /*! Looks for a valid matching extension */
351 /*!
352   \param c not really important
353   \param context context to serach within
354   \param exten extension to check
355   \param priority priority of extension path
356   \param callerid callerid of extension being searched for
357    If "exten" *could be* a valid extension in this context with or without
358    some more digits, return non-zero.  Basically, when this returns 0, no matter
359    what you add to exten, it's not going to be a valid extension anymore
360 */
361 int ast_canmatch_extension(struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid);
362
363 /*! Looks to see if adding anything to this extension might match something. (exists ^ canmatch) */
364 /*!
365   \param c not really important
366   \param context context to serach within
367   \param exten extension to check
368   \param priority priority of extension path
369   \param callerid callerid of extension being searched for
370    If "exten" *could match* a valid extension in this context with
371    some more digits, return non-zero.  Does NOT return non-zero if this is
372    an exact-match only.  Basically, when this returns 0, no matter
373    what you add to exten, it's not going to be a valid extension anymore
374 */
375 int ast_matchmore_extension(struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid);
376
377 /*! Determine if a given extension matches a given pattern (in NXX format) */
378 /*!
379  * \param pattern pattern to match
380  * \param extension extension to check against the pattern.
381  * Checks whether or not the given extension matches the given pattern.
382  * Returns 1 on match, 0 on failure
383  */
384 int ast_extension_match(const char *pattern, const char *extension);
385 int ast_extension_close(const char *pattern, const char *data, int needmore);
386 /*! Launch a new extension (i.e. new stack) */
387 /*!
388  * \param c not important
389  * \param context which context to generate the extension within
390  * \param exten new extension to add
391  * \param priority priority of new extension
392  * \param callerid callerid of extension
393  * This adds a new extension to the asterisk extension list.
394  * It returns 0 on success, -1 on failure.
395  */
396 int ast_spawn_extension(struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid);
397
398 /*! Execute an extension. */
399 /*!
400   \param c channel to execute upon
401   \param context which context extension is in
402   \param exten extension to execute
403   \param priority priority to execute within the given extension
404   \param callerid Caller-ID
405    If it's not available, do whatever you should do for
406    default extensions and halt the thread if necessary.  This function does not
407    return, except on error.
408 */
409 int ast_exec_extension(struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid);
410
411 /*! Add an include */
412 /*!
413   \param context context to add include to
414   \param include new include to add
415   \param registrar who's registering it
416    Adds an include taking a char * string as the context parameter
417    Returns 0 on success, -1 on error
418 */
419 int ast_context_add_include(const char *context, const char *include, const char *registrar);
420
421 /*! Add an include */
422 /*!
423   \param con context to add the include to
424   \param include include to add
425   \param registrar who registered the context
426    Adds an include taking a struct ast_context as the first parameter
427    Returns 0 on success, -1 on failure
428 */
429 int ast_context_add_include2(struct ast_context *con, const char *include, const char *registrar);
430
431 /*! Removes an include */
432 /*!
433  * See add_include
434  */
435 int ast_context_remove_include(const char *context, const char *include,const  char *registrar);
436 /*! Removes an include by an ast_context structure */
437 /*!
438  * See add_include2
439  */
440 int ast_context_remove_include2(struct ast_context *con, const char *include, const char *registrar);
441
442 /*! Verifies includes in an ast_contect structure */
443 /*!
444  * \param con context in which to verify the includes
445  * Returns 0 if no problems found, -1 if there were any missing context
446  */
447 int ast_context_verify_includes(struct ast_context *con);
448           
449 /*! Add a switch */
450 /*!
451  * \param context context to which to add the switch
452  * \param sw switch to add
453  * \param data data to pass to switch
454  * \param eval whether to evaluate variables when running switch
455  * \param registrar whoever registered the switch
456  * This function registers a switch with the asterisk switch architecture
457  * It returns 0 on success, -1 on failure
458  */
459 int ast_context_add_switch(const char *context, const char *sw, const char *data, int eval, const char *registrar);
460 /*! Adds a switch (first param is a ast_context) */
461 /*!
462  * See ast_context_add_switch()
463  */
464 int ast_context_add_switch2(struct ast_context *con, const char *sw, const char *data, int eval, const char *registrar);
465
466 /*! Remove a switch */
467 /*!
468  * Removes a switch with the given parameters
469  * Returns 0 on success, -1 on failure
470  */
471 int ast_context_remove_switch(const char *context, const char *sw, const char *data, const char *registrar);
472 int ast_context_remove_switch2(struct ast_context *con, const char *sw, const char *data, const char *registrar);
473
474 /*! Simply remove extension from context */
475 /*!
476  * \param context context to remove extension from
477  * \param extension which extension to remove
478  * \param priority priority of extension to remove
479  * \param registrar registrar of the extension
480  * This function removes an extension from a given context.
481  * Returns 0 on success, -1 on failure
482  */
483 int ast_context_remove_extension(const char *context, const char *extension, int priority,
484         const char *registrar);
485 int ast_context_remove_extension2(struct ast_context *con, const char *extension,
486         int priority, const char *registrar);
487
488 /*! Add an ignorepat */
489 /*!
490  * \param context which context to add the ignorpattern to
491  * \param ignorepat ignorepattern to set up for the extension
492  * \param registrar registrar of the ignore pattern
493  * Adds an ignore pattern to a particular context.
494  * Returns 0 on success, -1 on failure
495  */
496 int ast_context_add_ignorepat(const char *context, const char *ignorepat, const char *registrar);
497 int ast_context_add_ignorepat2(struct ast_context *con, const char *ignorepat, const char *registrar);
498
499 /* Remove an ignorepat */
500 /*!
501  * \param context context from which to remove the pattern
502  * \param ignorepat the pattern to remove
503  * \param registrar the registrar of the ignore pattern
504  * This removes the given ignorepattern
505  * Returns 0 on success, -1 on failure
506  */
507 int ast_context_remove_ignorepat(const char *context, const char *ignorepat, const char *registrar);
508 int ast_context_remove_ignorepat2(struct ast_context *con, const char *ignorepat, const char *registrar);
509
510 /*! Checks to see if a number should be ignored */
511 /*!
512  * \param context context to search within
513  * \param pattern to check whether it should be ignored or not
514  * Check if a number should be ignored with respect to dialtone cancellation.  
515  * Returns 0 if the pattern should not be ignored, or non-zero if the pattern should be ignored 
516  */
517 int ast_ignore_pattern(const char *context, const char *pattern);
518
519 /* Locking functions for outer modules, especially for completion functions */
520 /*! Locks the contexts */
521 /*! Locks the context list
522  * Returns 0 on success, -1 on error
523  */
524 int ast_lock_contexts(void);
525
526 /*! Unlocks contexts */
527 /*!
528  * Returns 0 on success, -1 on failure
529  */
530 int ast_unlock_contexts(void);
531
532 /*! Locks a given context */
533 /*!
534  * \param con context to lock
535  * Locks the context.
536  * Returns 0 on success, -1 on failure
537  */
538 int ast_lock_context(struct ast_context *con);
539 /*! Unlocks the given context */
540 /*!
541  * \param con context to unlock
542  * Unlocks the given context
543  * Returns 0 on success, -1 on failure
544  */
545 int ast_unlock_context(struct ast_context *con);
546
547
548 int ast_async_goto(struct ast_channel *chan, const char *context, const char *exten, int priority);
549
550 int ast_async_goto_by_name(const char *chan, const char *context, const char *exten, int priority);
551
552 /* Synchronously or asynchronously make an outbound call and send it to a
553    particular extension */
554 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);
555
556 /* Synchronously or asynchronously make an outbound call and send it to a
557    particular application with given extension */
558 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);
559
560 /* Functions for returning values from structures */
561 const char *ast_get_context_name(struct ast_context *con);
562 const char *ast_get_extension_name(struct ast_exten *exten);
563 const char *ast_get_include_name(struct ast_include *include);
564 const char *ast_get_ignorepat_name(struct ast_ignorepat *ip);
565 const char *ast_get_switch_name(struct ast_sw *sw);
566 const char *ast_get_switch_data(struct ast_sw *sw);
567
568 /* Other extension stuff */
569 int ast_get_extension_priority(struct ast_exten *exten);
570 int ast_get_extension_matchcid(struct ast_exten *e);
571 const char *ast_get_extension_cidmatch(struct ast_exten *e);
572 const char *ast_get_extension_app(struct ast_exten *e);
573 const char *ast_get_extension_label(struct ast_exten *e);
574 void *ast_get_extension_app_data(struct ast_exten *e);
575
576 /* Registrar info functions ... */
577 const char *ast_get_context_registrar(struct ast_context *c);
578 const char *ast_get_extension_registrar(struct ast_exten *e);
579 const char *ast_get_include_registrar(struct ast_include *i);
580 const char *ast_get_ignorepat_registrar(struct ast_ignorepat *ip);
581 const char *ast_get_switch_registrar(struct ast_sw *sw);
582
583 /* Walking functions ... */
584 struct ast_context *ast_walk_contexts(struct ast_context *con);
585 struct ast_exten *ast_walk_context_extensions(struct ast_context *con,
586         struct ast_exten *priority);
587 struct ast_exten *ast_walk_extension_priorities(struct ast_exten *exten,
588         struct ast_exten *priority);
589 struct ast_include *ast_walk_context_includes(struct ast_context *con,
590         struct ast_include *inc);
591 struct ast_ignorepat *ast_walk_context_ignorepats(struct ast_context *con,
592         struct ast_ignorepat *ip);
593 struct ast_sw *ast_walk_context_switches(struct ast_context *con, struct ast_sw *sw);
594
595 int pbx_builtin_serialize_variables(struct ast_channel *chan, char *buf, size_t size);
596 extern const char *pbx_builtin_getvar_helper(struct ast_channel *chan, const char *name);
597 extern void pbx_builtin_pushvar_helper(struct ast_channel *chan, const char *name, const char *value);
598 extern void pbx_builtin_setvar_helper(struct ast_channel *chan, const char *name, const char *value);
599 extern void pbx_retrieve_variable(struct ast_channel *c, const char *var, char **ret, char *workspace, int workspacelen, struct varshead *headp);
600 extern void pbx_builtin_clear_globals(void);
601 extern int pbx_builtin_setvar(struct ast_channel *chan, void *data);
602 extern void pbx_substitute_variables_helper(struct ast_channel *c,const char *cp1,char *cp2,int count);
603 extern void pbx_substitute_variables_varshead(struct varshead *headp, const char *cp1, char *cp2, int count);
604
605 int ast_extension_patmatch(const char *pattern, const char *data);
606
607 /* Set "autofallthrough" flag, if newval is <0, does not acutally set.  If
608   set to 1, sets to auto fall through.  If newval set to 0, sets to no auto
609   fall through (reads extension instead).  Returns previous value. */
610 extern int pbx_set_autofallthrough(int newval);
611 int ast_goto_if_exists(struct ast_channel *chan, const char *context, const char *exten, int priority);
612 /* I can find neither parsable nor parseable at dictionary.com, but google gives me 169000 hits for parseable and only 49,800 for parsable */
613 int ast_parseable_goto(struct ast_channel *chan, const char *goto_string);
614 int ast_explicit_goto(struct ast_channel *chan, const char *context, const char *exten, int priority);
615 int ast_async_goto_if_exists(struct ast_channel *chan, const char *context, const char *exten, int priority);
616
617 struct ast_custom_function* ast_custom_function_find(const char *name);
618 int ast_custom_function_unregister(struct ast_custom_function *acf);
619 int ast_custom_function_register(struct ast_custom_function *acf);
620
621 /* Number of active calls */
622 int ast_active_calls(void);
623         
624 /*! executes a read operation on a function */
625 /*!
626  * \param chan Channel to execute on
627  * \param function Data containing the function call string (will be modified)
628  * \param workspace A pointer to safe memory to use for a return value 
629  * \param len the number of bytes in workspace
630  * \return zero on success, non-zero on failure
631  * This application executes an function in read mode on a given channel.
632  *  */
633         
634 int ast_func_read(struct ast_channel *chan, char *function, char *workspace, size_t len);
635
636 /*! executes a write operation on a function */
637 /*!
638  * \param chan Channel to execute on
639  * \param function Data containing the function call string (will be modified)
640  * \param value A value parameter to pass for writing
641  * \return zero on success, non-zero on failure
642  * This application executes an function in write mode on a given channel.
643  */
644 int ast_func_write(struct ast_channel *chan, char *function, const char *value);
645
646 void ast_hint_state_changed(const char *device);
647
648 #if defined(__cplusplus) || defined(c_plusplus)
649 }
650 #endif
651
652 #endif /* _ASTERISK_PBX_H */