Asterisk - The Open Source Telephony Project  18.5.0
Data Structures | Macros | Typedefs | Enumerations | Functions
include/asterisk/app.h File Reference

Application convenience functions, designed to give consistent look and feel to Asterisk apps. More...

#include "asterisk/stringfields.h"
#include "asterisk/strings.h"
#include "asterisk/threadstorage.h"
#include "asterisk/file.h"
#include "asterisk/linkedlists.h"
#include "asterisk/utils.h"
#include "asterisk/stasis.h"
Include dependency graph for include/asterisk/app.h:

Go to the source code of this file.

Data Structures

struct  ast_app_option
 A structure to hold the description of an application 'option'. More...
 
struct  ast_app_stack_funcs
 Stack applications callback functions. More...
 
struct  ast_ivr_menu
 
struct  ast_ivr_option
 
struct  ast_vm_functions
 Voicemail function table definition. More...
 
struct  ast_vm_greeter_functions
 Voicemail greeter function table definition. More...
 
struct  ast_vm_mailbox_snapshot
 
struct  ast_vm_msg_snapshot
 
struct  ast_vm_recording_data
 Structure used for ast_copy_recording_to_vm in order to cleanly supply data needed for making the recording from the recorded file. More...
 

Macros

#define AST_APP_ARG(name)   char *name
 Define an application argument. More...
 
#define AST_APP_OPTION(option, flagno)   [option] = { .flag = flagno }
 Declares an application option that does not accept an argument. More...
 
#define AST_APP_OPTION_ARG(option, flagno, argno)   [option] = { .flag = flagno, .arg_index = argno + 1 }
 Declares an application option that accepts an argument. More...
 
#define AST_APP_OPTIONS(holder, options...)   static const struct ast_app_option holder[128] = options
 Declares an array of options for an application. More...
 
#define ast_app_separate_args(a, b, c, d)   __ast_app_separate_args(a,b,1,c,d)
 
#define AST_DECLARE_APP_ARGS(name, arglist)   AST_DEFINE_APP_ARGS_TYPE(argtype_##name, arglist) name = { 0, }
 Declare a structure to hold an application's arguments. More...
 
#define AST_DEFINE_APP_ARGS_TYPE(type, arglist)
 Define a structure type to hold an application's arguments. More...
 
#define AST_IVR_DECLARE_MENU(holder, title, flags, foo...)
 
#define AST_IVR_FLAG_AUTORESTART   (1 << 0)
 
#define AST_NONSTANDARD_APP_ARGS(args, parse, sep)   args.argc = __ast_app_separate_args(parse, sep, 1, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))
 Performs the 'nonstandard' argument separation process for an application. More...
 
#define AST_NONSTANDARD_RAW_ARGS(args, parse, sep)   args.argc = __ast_app_separate_args(parse, sep, 0, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))
 
#define AST_STANDARD_APP_ARGS(args, parse)   args.argc = __ast_app_separate_args(parse, ',', 1, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))
 Performs the 'standard' argument separation process for an application. More...
 
#define AST_STANDARD_RAW_ARGS(args, parse)   args.argc = __ast_app_separate_args(parse, ',', 0, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))
 
#define ast_vm_greeter_register(vm_table)   __ast_vm_greeter_register(vm_table, AST_MODULE_SELF)
 See __ast_vm_greeter_register() More...
 
#define ast_vm_register(vm_table)   __ast_vm_register(vm_table, AST_MODULE_SELF)
 See __ast_vm_register() More...
 
#define BEGIN_OPTIONS   {
 
#define END_OPTIONS   }
 
#define VM_GREETER_MODULE_VERSION   1
 
#define VM_MODULE_VERSION   2
 

Typedefs

typedef int() ast_copy_recording_to_vm_fn(struct ast_vm_recording_data *vm_rec_data)
 Creates a voicemail based on a specified file to a mailbox. More...
 
typedef int() ast_has_voicemail_fn(const char *mailboxes, const char *folder)
 Determines if the given folder has messages. More...
 
typedef int() ast_inboxcount2_fn(const char *mailboxes, int *urgentmsgs, int *newmsgs, int *oldmsgs)
 Gets the number of messages that exist for the mailbox list. More...
 
typedef int() ast_inboxcount_fn(const char *mailboxes, int *newmsgs, int *oldmsgs)
 Gets the number of messages that exist for the mailbox list. More...
 
typedef int() ast_ivr_callback(struct ast_channel *chan, char *option, void *cbdata)
 Callback function for IVR. More...
 
typedef int() ast_messagecount_fn(const char *mailbox_id, const char *folder)
 Gets the number of messages that exist in a mailbox folder. More...
 
typedef int() ast_sayname_fn(struct ast_channel *chan, const char *mailbox_id)
 Play a recorded user name for the mailbox to the specified channel. More...
 
typedef const char *() ast_vm_index_to_foldername_fn(int id)
 Convert the mailbox folder id to a folder name. More...
 
typedef struct ast_vm_mailbox_snapshot *() ast_vm_mailbox_snapshot_create_fn(const char *user, const char *context, const char *folder, int descending, enum ast_vm_snapshot_sort_val sort_val, int combine_INBOX_and_OLD)
 Create a snapshot of a mailbox which contains information about every msg. More...
 
typedef struct ast_vm_mailbox_snapshot *() ast_vm_mailbox_snapshot_destroy_fn(struct ast_vm_mailbox_snapshot *mailbox_snapshot)
 destroy a snapshot More...
 
typedef int() ast_vm_msg_forward_fn(const char *from_mailbox, const char *from_context, const char *from_folder, const char *to_mailbox, const char *to_context, const char *to_folder, size_t num_msgs, const char *msg_ids[], int delete_old)
 forward a message from one mailbox to another. More...
 
typedef int() ast_vm_msg_move_fn(const char *mailbox, const char *context, size_t num_msgs, const char *oldfolder, const char *old_msg_ids[], const char *newfolder)
 Move messages from one folder to another. More...
 
typedef void() ast_vm_msg_play_cb(struct ast_channel *chan, const char *playfile, int duration)
 Voicemail playback callback function definition. More...
 
typedef int() ast_vm_msg_play_fn(struct ast_channel *chan, const char *mailbox, const char *context, const char *folder, const char *msg_num, ast_vm_msg_play_cb *cb)
 Play a voicemail msg back on a channel. More...
 
typedef int() ast_vm_msg_remove_fn(const char *mailbox, const char *context, size_t num_msgs, const char *folder, const char *msgs[])
 Remove/delete messages from a mailbox folder. More...
 
typedef int() ast_vm_test_create_user_fn(const char *context, const char *user)
 
typedef int() ast_vm_test_destroy_user_fn(const char *context, const char *user)
 

Enumerations

enum  ast_getdata_result {
  AST_GETDATA_FAILED = -1, AST_GETDATA_COMPLETE = 0, AST_GETDATA_TIMEOUT = 1, AST_GETDATA_INTERRUPTED = 2,
  AST_GETDATA_EMPTY_END_TERMINATED = 3
}
 
enum  ast_ivr_action {
  AST_ACTION_UPONE, AST_ACTION_EXIT, AST_ACTION_CALLBACK, AST_ACTION_PLAYBACK,
  AST_ACTION_BACKGROUND, AST_ACTION_PLAYLIST, AST_ACTION_MENU, AST_ACTION_REPEAT,
  AST_ACTION_RESTART, AST_ACTION_TRANSFER, AST_ACTION_WAITOPTION, AST_ACTION_NOOP,
  AST_ACTION_BACKLIST
}
 
enum  AST_LOCK_RESULT { AST_LOCK_SUCCESS = 0, AST_LOCK_TIMEOUT = -1, AST_LOCK_PATH_NOT_FOUND = -2, AST_LOCK_FAILURE = -3 }
 
enum  AST_LOCK_TYPE { AST_LOCK_TYPE_LOCKFILE = 0, AST_LOCK_TYPE_FLOCK = 1 }
 Type of locking to use in ast_lock_path / ast_unlock_path. More...
 
enum  ast_record_if_exists { AST_RECORD_IF_EXISTS_ERROR = -1, AST_RECORD_IF_EXISTS_FAIL, AST_RECORD_IF_EXISTS_OVERWRITE, AST_RECORD_IF_EXISTS_APPEND }
 
enum  ast_timelen { TIMELEN_HOURS, TIMELEN_MINUTES, TIMELEN_SECONDS, TIMELEN_MILLISECONDS }
 
enum  ast_vm_snapshot_sort_val { AST_VM_SNAPSHOT_SORT_BY_ID = 0, AST_VM_SNAPSHOT_SORT_BY_TIME }
 

Functions

unsigned int __ast_app_separate_args (char *buf, char delim, int remove_chars, char **array, int arraylen)
 Separate a string into arguments in an array. More...
 
int __ast_vm_greeter_register (const struct ast_vm_greeter_functions *vm_table, struct ast_module *module)
 Set voicemail greeter function callbacks. More...
 
int __ast_vm_register (const struct ast_vm_functions *vm_table, struct ast_module *module)
 Set voicemail function callbacks. More...
 
int app_init (void)
 Initialize the application core. More...
 
int ast_app_copy_recording_to_vm (struct ast_vm_recording_data *vm_rec_data)
 param[in] vm_rec_data Contains data needed to make the recording. retval 0 voicemail successfully created from recording. retval -1 Failure More...
 
int ast_app_dtget (struct ast_channel *chan, const char *context, char *collect, size_t size, int maxlen, int timeout)
 Present a dialtone and collect a certain length extension. More...
 
int ast_app_exec_macro (struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char *macro_args)
 Run a macro on a channel, placing an optional second channel into autoservice. More...
 
int ast_app_exec_sub (struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_args, int ignore_hangup)
 Run a subroutine on a channel, placing an optional second channel into autoservice. More...
 
const char * ast_app_expand_sub_args (struct ast_channel *chan, const char *args)
 Add missing context/exten to subroutine argument string. More...
 
int ast_app_getdata (struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout)
 Plays a stream and gets DTMF data from a channel. More...
 
int ast_app_getdata_full (struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout, int audiofd, int ctrlfd)
 Full version with audiofd and controlfd. NOTE: returns '2' on ctrlfd available, not '1' like other full functions. More...
 
int ast_app_group_discard (struct ast_channel *chan)
 Discard all group counting for a channel. More...
 
int ast_app_group_get_count (const char *group, const char *category)
 Get the current channel count of the specified group and category. More...
 
struct ast_group_infoast_app_group_list_head (void)
 Get the head of the group count list. More...
 
int ast_app_group_list_rdlock (void)
 Read Lock the group count list. More...
 
int ast_app_group_list_unlock (void)
 Unlock the group count list. More...
 
int ast_app_group_list_wrlock (void)
 Write Lock the group count list. More...
 
int ast_app_group_match_get_count (const char *groupmatch, const char *category)
 Get the current channel count of all groups that match the specified pattern and category. More...
 
int ast_app_group_set_channel (struct ast_channel *chan, const char *data)
 Set the group for a channel, splitting the provided data into group and category, if specified. More...
 
int ast_app_group_split_group (const char *data, char *group, int group_max, char *category, int category_max)
 Split a group string into group and category, returning a default category if none is provided. More...
 
int ast_app_group_update (struct ast_channel *oldchan, struct ast_channel *newchan)
 Update all group counting for a channel to a new one. More...
 
int ast_app_has_voicemail (const char *mailboxes, const char *folder)
 Determine if a given mailbox has any voicemail If folder is NULL, defaults to "INBOX". If folder is "INBOX", includes the number of messages in the "Urgent" folder. More...
 
int ast_app_inboxcount (const char *mailboxes, int *newmsgs, int *oldmsgs)
 Determine number of new/old messages in a mailbox. More...
 
int ast_app_inboxcount2 (const char *mailboxes, int *urgentmsgs, int *newmsgs, int *oldmsgs)
 Determine number of urgent/new/old messages in a mailbox. More...
 
int ast_app_messagecount (const char *mailbox_id, const char *folder)
 Get the number of messages in a given mailbox folder. More...
 
void ast_app_options2str64 (const struct ast_app_option *options, struct ast_flags64 *flags, char *buf, size_t len)
 Given a list of options array, return an option string based on passed flags. More...
 
int ast_app_parse_options (const struct ast_app_option *options, struct ast_flags *flags, char **args, char *optstr)
 Parses a string containing application options and sets flags/arguments. More...
 
int ast_app_parse_options64 (const struct ast_app_option *options, struct ast_flags64 *flags, char **args, char *optstr)
 Parses a string containing application options and sets flags/arguments. More...
 
int ast_app_parse_timelen (const char *timestr, int *result, enum ast_timelen defunit)
 Common routine to parse time lengths, with optional time unit specifier. More...
 
int ast_app_run_macro (struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char *macro_name, const char *macro_args)
 Run a macro on a channel, placing an optional second channel into autoservice. More...
 
int ast_app_run_sub (struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_location, const char *sub_args, int ignore_hangup)
 Run a subroutine on a channel, placing an optional second channel into autoservice. More...
 
int ast_app_sayname (struct ast_channel *chan, const char *mailbox_id)
 Play a recorded user name for the mailbox to the specified channel. More...
 
void ast_close_fds_above_n (int n)
 Common routine for child processes, to close all fds prior to exec(2) More...
 
int ast_control_streamfile (struct ast_channel *chan, const char *file, const char *fwd, const char *rev, const char *stop, const char *pause, const char *restart, int skipms, long *offsetms)
 Stream a file with fast forward, pause, reverse, restart. More...
 
int ast_control_streamfile_lang (struct ast_channel *chan, const char *file, const char *fwd, const char *rev, const char *stop, const char *suspend, const char *restart, int skipms, const char *lang, long *offsetms)
 Version of ast_control_streamfile() which allows the language of the media file to be specified. More...
 
int ast_control_streamfile_w_cb (struct ast_channel *chan, const char *file, const char *fwd, const char *rev, const char *stop, const char *pause, const char *restart, int skipms, long *offsetms, ast_waitstream_fr_cb cb)
 Stream a file with fast forward, pause, reverse, restart. More...
 
int ast_control_tone (struct ast_channel *chan, const char *tone)
 Controls playback of a tone. More...
 
int ast_dtmf_stream (struct ast_channel *chan, struct ast_channel *peer, const char *digits, int between, unsigned int duration)
 Send a string of DTMF digits to a channel. More...
 
void ast_dtmf_stream_external (struct ast_channel *chan, const char *digits, int between, unsigned int duration)
 Send a string of DTMF digits to a channel from an external thread. More...
 
int ast_get_encoded_char (const char *stream, char *result, size_t *consumed)
 Decode an encoded control or extended ASCII character. More...
 
char * ast_get_encoded_str (const char *stream, char *result, size_t result_len)
 Decode a stream of encoded control or extended ASCII characters. More...
 
void ast_install_stack_functions (const struct ast_app_stack_funcs *funcs)
 Set stack application function callbacks. More...
 
void ast_install_vm_test_functions (ast_vm_test_create_user_fn *vm_test_create_user_func, ast_vm_test_destroy_user_fn *vm_test_destroy_user_func)
 
int ast_ivr_menu_run (struct ast_channel *c, struct ast_ivr_menu *menu, void *cbdata)
 Runs an IVR menu. More...
 
int ast_linear_stream (struct ast_channel *chan, const char *filename, int fd, int allowoverride)
 Stream a filename (or file descriptor) as a generator. More...
 
enum AST_LOCK_RESULT ast_lock_path (const char *path)
 Lock a filesystem path. More...
 
int ast_mf_stream (struct ast_channel *chan, struct ast_channel *peer, const char *digits, int between, unsigned int duration, unsigned int durationkp, unsigned int durationst, int is_external)
 Send a string of MF digits to a channel. More...
 
int ast_play_and_prepend (struct ast_channel *chan, char *playfile, char *recordfile, int maxtime_sec, char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence_ms)
 Record a file based on input frm a channel. Recording is performed in 'prepend' mode which works a little differently from normal recordings This function will not play a success message due to post-recording control in the application this was added for. More...
 
int ast_play_and_record (struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime_sec, const char *fmt, int *duration, int *sound_duration, int silencethreshold, int maxsilence_ms, const char *path)
 Record a file based on input from a channel. Use default accept and cancel DTMF. This function will play "auth-thankyou" upon successful recording. More...
 
int ast_play_and_record_full (struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime_sec, const char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence_ms, const char *path, const char *acceptdtmf, const char *canceldtmf, int skip_confirmation_sound, enum ast_record_if_exists if_exists)
 Record a file based on input from a channel This function will play "auth-thankyou" upon successful recording if skip_confirmation_sound is false. More...
 
int ast_play_and_wait (struct ast_channel *chan, const char *fn)
 Play a stream and wait for a digit, returning the digit that was pressed. More...
 
struct stasis_topicast_queue_topic (const char *queuename)
 Get the Stasis Message Bus API topic for queue messages for a particular queue name. More...
 
struct stasis_topicast_queue_topic_all (void)
 Get the Stasis Message Bus API topic for queue messages. More...
 
char * ast_read_textfile (const char *file)
 Read a file into asterisk. More...
 
int ast_record_review (struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, const char *path)
 Allow to record message and have a review option. More...
 
void ast_replace_sigchld (void)
 Replace the SIGCHLD handler. More...
 
int ast_safe_execvp (int dualfork, const char *file, char *const argv[])
 Safely spawn an external program while closing file descriptors. More...
 
int ast_safe_fork (int stop_reaper)
 Common routine to safely fork without a chance of a signal handler firing badly in the child. More...
 
void ast_safe_fork_cleanup (void)
 Common routine to cleanup after fork'ed process is complete (if reaping was stopped) More...
 
int ast_safe_system (const char *s)
 Safely spawn an OS shell command while closing file descriptors. More...
 
void ast_set_lock_type (enum AST_LOCK_TYPE type)
 Set the type of locks used by ast_lock_path() More...
 
int ast_str_get_encoded_str (struct ast_str **str, int maxlen, const char *stream)
 Decode a stream of encoded control or extended ASCII characters. More...
 
 AST_THREADSTORAGE_EXTERNAL (ast_str_thread_global_buf)
 
void ast_uninstall_vm_test_functions (void)
 
int ast_unlock_path (const char *path)
 Unlock a path. More...
 
void ast_unreplace_sigchld (void)
 Restore the SIGCHLD handler. More...
 
int ast_vm_greeter_is_registered (void)
 Determine if a voicemail greeter provider is registered. More...
 
void ast_vm_greeter_unregister (const char *module_name)
 Unregister the specified voicemail greeter provider. More...
 
const char * ast_vm_index_to_foldername (int id)
 Return name of folder, given an id. More...
 
int ast_vm_is_registered (void)
 Determine if a voicemail provider is registered. More...
 
struct ast_vm_mailbox_snapshotast_vm_mailbox_snapshot_create (const char *mailbox, const char *context, const char *folder, int descending, enum ast_vm_snapshot_sort_val sort_val, int combine_INBOX_and_OLD)
 Create a snapshot of a mailbox which contains information about every msg. More...
 
struct ast_vm_mailbox_snapshotast_vm_mailbox_snapshot_destroy (struct ast_vm_mailbox_snapshot *mailbox_snapshot)
 destroy a snapshot More...
 
int ast_vm_msg_forward (const char *from_mailbox, const char *from_context, const char *from_folder, const char *to_mailbox, const char *to_context, const char *to_folder, size_t num_msgs, const char *msg_ids[], int delete_old)
 forward a message from one mailbox to another. More...
 
int ast_vm_msg_move (const char *mailbox, const char *context, size_t num_msgs, const char *oldfolder, const char *old_msg_ids[], const char *newfolder)
 Move messages from one folder to another. More...
 
int ast_vm_msg_play (struct ast_channel *chan, const char *mailbox, const char *context, const char *folder, const char *msg_num, ast_vm_msg_play_cb *cb)
 Play a voicemail msg back on a channel. More...
 
int ast_vm_msg_remove (const char *mailbox, const char *context, size_t num_msgs, const char *folder, const char *msgs[])
 Remove/delete messages from a mailbox folder. More...
 
int ast_vm_test_create_user (const char *context, const char *mailbox)
 
int ast_vm_test_destroy_user (const char *context, const char *mailbox)
 
void ast_vm_test_swap_table_in (const struct ast_vm_functions *vm_table)
 Swap out existing voicemail functions with a temporary set of functions for use with unit tests. More...
 
void ast_vm_test_swap_table_out (void)
 Used after ast_vm_test_swap_table_in to restore the original set of voicemail functions. More...
 
void ast_vm_unregister (const char *module_name)
 Unregister the specified voicemail provider. More...
 

Detailed Description

Application convenience functions, designed to give consistent look and feel to Asterisk apps.

Definition in file include/asterisk/app.h.

Macro Definition Documentation

◆ AST_APP_ARG

#define AST_APP_ARG (   name)    char *name

Define an application argument.

Parameters
nameThe name of the argument

Definition at line 1232 of file include/asterisk/app.h.

Referenced by acf_abs_exec(), acf_curl_exec(), acf_curl_write(), acf_if(), acf_isexten_exec(), acf_jabberreceive_read(), acf_jabberstatus_read(), acf_max_exec(), acf_meetme_info(), acf_min_exec(), acf_odbc_read(), acf_odbc_write(), acf_rand_exec(), acf_sprintf(), acf_strftime(), acf_strptime(), acf_transaction_read(), acf_transaction_write(), acf_version_exec(), acf_vm_info(), acf_vmcount_exec(), action_status(), add_action_to_menu_entry(), admin_exec(), aelsub_exec(), aes_helper(), agent_function_read(), agent_login_exec(), agent_request_exec(), agi_exec_full(), aMYSQL_connect(), aMYSQL_fetch(), aMYSQL_nextresult(), aMYSQL_query(), aMYSQL_set(), app_exec(), applicationmap_handler(), aqm_exec(), array(), ast_eivr_senddtmf(), ast_queue_log(), asyncgoto_exec(), attended_transfer_exec(), audiosocket_exec(), audiosocket_request(), auth_exec(), background_detect_exec(), blind_transfer_exec(), bridge_exec(), bridgewait_exec(), build_profile(), calendar_query_exec(), calendar_query_result_exec(), calendar_write_exec(), callerid_read(), cb_events(), cdr_prop_write_callback(), cdr_read_callback(), cdr_write(), cdr_write_callback(), celgenuserevent_exec(), chanavail_exec(), channel_admin_exec(), channelvars_handler(), chanspy_exec(), cli_odbc_read(), cli_odbc_write(), conf_exec(), confbridge_exec(), config_function_read(), confkick_exec(), controlplayback_exec(), count_exec(), create_addr(), cut_internal(), dahdi_call(), destroy_all_channels(), detect_write(), determine_starting_point(), dial_exec_full(), dialgroup_write(), dictate_exec(), directory_exec(), disa_exec(), dtmfstore_exec(), dundi_query_read(), dundi_result_read(), dundifunc_read(), enable_jack_hook(), enum_query_read(), enum_result_read(), execif_exec(), extenspy_exec(), festival_exec(), file_count_line(), file_read(), file_write(), filter(), find_conf(), find_realtime_gw(), find_table_cb(), forkcdr_exec(), func_confbridge_helper(), func_confbridge_info(), func_get_parkingslot_channel(), func_header_read(), func_headers_read2(), func_mixmonitor_read(), func_read_header(), func_write_header(), function_amiclient(), function_db_delete(), function_db_exists(), function_db_read(), function_db_write(), function_enum(), function_fieldnum_helper(), function_fieldqty_helper(), function_realtime_read(), function_realtime_readdestroy(), function_realtime_store(), function_realtime_write(), function_txtcidname(), gosub_exec(), gosubif_exec(), hangupcause_read(), hash_read(), hash_write(), hint_read(), hook_on(), iconv_read(), import_helper(), init_acf_query(), isAnsweringMachine(), isexten_function_read(), jb_helper(), jingle_request(), listfilter(), load_channelvars(), load_values_config(), log_exec(), man_do_variable_value(), math(), mbl_sendsms_exec(), mbl_status_exec(), misdn_call(), misdn_check_l2l1(), misdn_facility_exec(), misdn_request(), mixmonitor_exec(), msg_send_exec(), multicast_rtp_request(), my_on_hook(), originate_exec(), ospauth_exec(), ospfinished_exec(), osplookup_exec(), ospnext_exec(), oss_call(), oss_request(), page_exec(), park_and_announce_app_exec(), park_app_parse_data(), parked_call_app_exec(), pbx_builtin_answer(), pbx_builtin_background(), pbx_builtin_saycharacters_case(), pbx_builtin_setvar_multiple(), pbx_builtin_waitdigit(), pbx_builtin_waitexten(), peek_read(), pickupchan_exec(), pjsip_acf_channel_read(), pjsip_acf_dial_contacts_read(), pjsip_acf_parse_uri_read(), pjsip_aor_function_read(), pjsip_contact_function_read(), pjsip_endpoint_function_read(), play_moh_exec(), playback_exec(), pp_each_extension_helper(), pqm_exec(), presence_read(), privacy_exec(), ql_exec(), queue_exec(), queue_function_mem_read(), queue_function_mem_write(), queue_function_memberpenalty_read(), queue_function_memberpenalty_write(), queue_function_queuegetchannel(), qupd_exec(), rcvfax_exec(), read_exec(), read_mf_exec(), read_sf_exec(), readexten_exec(), realtimefield_read(), receivefax_exec(), record_exec(), reg_source_db(), regex(), reload(), reload_single_member(), replace(), request(), retrydial_exec(), rqm_exec(), saycountedadj_exec(), saycountednoun_exec(), sayfile_exec(), sayunixtime_exec(), scramble_write(), senddtmf_exec(), sendfax_exec(), sendmf_exec(), sendurl_exec(), shared_read(), shared_write(), shift_pop(), sip_acf_channel_read(), sip_parse_register_line(), sip_request_call(), sla_trunk_exec(), smdi_msg_read(), smdi_msg_retrieve_read(), sms_exec(), sndfax_exec(), softhangup_exec(), sorcery_function_read(), speech_background(), speech_load(), srv_result_read(), stackpeek_read(), start_moh_exec(), start_monitor_exec(), statsd_exec(), stir_shaken_read(), stop_mixmonitor_full(), stream_echo_exec(), strreplace(), talk_detect_fn_write(), transfer_exec(), unicast_rtp_request(), unshift_push(), upqm_exec(), userevent_exec(), verbose_exec(), vm_check_password_shell(), vm_exec(), vm_execmain(), vm_playmsgexec(), volume_read(), volume_write(), wait_exec(), waitfor_exec(), xmpp_join_exec(), xmpp_leave_exec(), xmpp_send_exec(), xmpp_sendgroup_exec(), and zapateller_exec().

◆ AST_APP_OPTION

#define AST_APP_OPTION (   option,
  flagno 
)    [option] = { .flag = flagno }

Declares an application option that does not accept an argument.

Parameters
optionThe single character representing the option
flagnoThe flag index to be set if this option is present
See also
AST_APP_OPTIONS, ast_app_parse_options

Definition at line 1402 of file include/asterisk/app.h.

◆ AST_APP_OPTION_ARG

#define AST_APP_OPTION_ARG (   option,
  flagno,
  argno 
)    [option] = { .flag = flagno, .arg_index = argno + 1 }

Declares an application option that accepts an argument.

Parameters
optionThe single character representing the option
flagnoThe flag index to be set if this option is present
argnoThe index into the argument array where the argument should be placed
See also
AST_APP_OPTIONS, ast_app_parse_options

Definition at line 1413 of file include/asterisk/app.h.

Referenced by AST_TEST_DEFINE().

◆ AST_APP_OPTIONS

#define AST_APP_OPTIONS (   holder,
  options... 
)    static const struct ast_app_option holder[128] = options

Declares an array of options for an application.

Parameters
holderThe name of the array to be created
optionsThe actual options to be placed into the array
See also
ast_app_parse_options

This macro declares a 'static const' array of struct ast_option elements to hold the list of available options for an application. Each option must be declared using either the AST_APP_OPTION() or AST_APP_OPTION_ARG() macros.

Example usage:

enum my_app_option_flags {
OPT_JUMP = (1 << 0),
OPT_BLAH = (1 << 1),
OPT_BLORT = (1 << 2),
};
enum my_app_option_args {
OPT_ARG_BLAH = 0,
OPT_ARG_BLORT,
!! this entry tells how many possible arguments there are,
and must be the last entry in the list
};
AST_APP_OPTIONS(my_app_options, {
AST_APP_OPTION_ARG('b', OPT_BLAH, OPT_ARG_BLAH),
AST_APP_OPTION_BLORT('B', OPT_BLORT, OPT_ARG_BLORT),
});
static int my_app_exec(struct ast_channel *chan, void *data)
{
char *options;
struct ast_flags opts = { 0, };
char *opt_args[OPT_ARG_ARRAY_SIZE];
... do any argument parsing here ...
if (ast_app_parse_options(my_app_options, &opts, opt_args, options)) {
return -1;
}
}

Definition at line 1393 of file include/asterisk/app.h.

Referenced by AST_TEST_DEFINE().

◆ ast_app_separate_args

#define ast_app_separate_args (   a,
  b,
  c,
  d 
)    __ast_app_separate_args(a,b,1,c,d)

◆ AST_DECLARE_APP_ARGS

#define AST_DECLARE_APP_ARGS (   name,
  arglist 
)    AST_DEFINE_APP_ARGS_TYPE(argtype_##name, arglist) name = { 0, }

Declare a structure to hold an application's arguments.

Parameters
nameThe name of the structure
arglistThe list of arguments, defined using AST_APP_ARG

This macro declares a structure intended to be used in a call to ast_app_separate_args(). The structure includes all the arguments specified, plus an argv array that overlays them and an argc argument counter. The arguments must be declared using AST_APP_ARG, and they will all be character pointers (strings).

Note
The structure is not initialized, as the call to ast_app_separate_args() will perform that function before parsing the arguments.

Definition at line 1249 of file include/asterisk/app.h.

Referenced by acf_abs_exec(), acf_curl_exec(), acf_curl_write(), acf_if(), acf_isexten_exec(), acf_jabberreceive_read(), acf_jabberstatus_read(), acf_max_exec(), acf_meetme_info(), acf_min_exec(), acf_odbc_read(), acf_odbc_write(), acf_rand_exec(), acf_sprintf(), acf_strftime(), acf_strptime(), acf_transaction_read(), acf_transaction_write(), acf_version_exec(), acf_vm_info(), acf_vmcount_exec(), action_status(), add_action_to_menu_entry(), admin_exec(), aelsub_exec(), aes_helper(), agent_function_read(), agent_login_exec(), agent_request_exec(), agi_exec_full(), aMYSQL_connect(), aMYSQL_fetch(), aMYSQL_nextresult(), aMYSQL_query(), aMYSQL_set(), app_exec(), applicationmap_handler(), aqm_exec(), array(), ast_eivr_senddtmf(), ast_queue_log(), asyncgoto_exec(), attended_transfer_exec(), audiosocket_exec(), audiosocket_request(), auth_exec(), background_detect_exec(), blind_transfer_exec(), bridge_exec(), bridgewait_exec(), build_profile(), calendar_query_exec(), calendar_query_result_exec(), calendar_write_exec(), callerid_read(), cb_events(), cdr_prop_write_callback(), cdr_read_callback(), cdr_write(), cdr_write_callback(), celgenuserevent_exec(), chanavail_exec(), channel_admin_exec(), channelvars_handler(), chanspy_exec(), cli_odbc_read(), cli_odbc_write(), conf_exec(), confbridge_exec(), config_function_read(), confkick_exec(), controlplayback_exec(), count_exec(), create_addr(), cut_internal(), dahdi_call(), destroy_all_channels(), detect_write(), determine_starting_point(), dial_exec_full(), dialgroup_write(), dictate_exec(), directory_exec(), disa_exec(), dtmfstore_exec(), dundi_query_read(), dundi_result_read(), dundifunc_read(), enable_jack_hook(), enum_query_read(), enum_result_read(), execif_exec(), extenspy_exec(), festival_exec(), file_count_line(), file_read(), file_write(), filter(), find_conf(), find_realtime_gw(), find_table_cb(), forkcdr_exec(), func_confbridge_helper(), func_confbridge_info(), func_get_parkingslot_channel(), func_header_read(), func_headers_read2(), func_mixmonitor_read(), func_read_header(), func_write_header(), function_amiclient(), function_db_delete(), function_db_exists(), function_db_read(), function_db_write(), function_enum(), function_fieldnum_helper(), function_fieldqty_helper(), function_realtime_read(), function_realtime_readdestroy(), function_realtime_store(), function_realtime_write(), function_txtcidname(), gosub_exec(), gosubif_exec(), hangupcause_read(), hash_read(), hash_write(), hint_read(), hook_on(), iconv_read(), import_helper(), init_acf_query(), isAnsweringMachine(), isexten_function_read(), jb_helper(), jingle_request(), listfilter(), load_channelvars(), load_values_config(), log_exec(), man_do_variable_value(), math(), mbl_sendsms_exec(), mbl_status_exec(), misdn_call(), misdn_check_l2l1(), misdn_facility_exec(), misdn_request(), mixmonitor_exec(), msg_send_exec(), multicast_rtp_request(), my_on_hook(), originate_exec(), ospauth_exec(), ospfinished_exec(), osplookup_exec(), ospnext_exec(), oss_call(), oss_request(), page_exec(), park_and_announce_app_exec(), park_app_parse_data(), parked_call_app_exec(), pbx_builtin_answer(), pbx_builtin_background(), pbx_builtin_saycharacters_case(), pbx_builtin_setvar_multiple(), pbx_builtin_waitdigit(), pbx_builtin_waitexten(), peek_read(), pickupchan_exec(), pjsip_acf_channel_read(), pjsip_acf_dial_contacts_read(), pjsip_acf_parse_uri_read(), pjsip_aor_function_read(), pjsip_contact_function_read(), pjsip_endpoint_function_read(), play_moh_exec(), playback_exec(), pp_each_extension_helper(), pqm_exec(), presence_read(), privacy_exec(), ql_exec(), queue_exec(), queue_function_mem_read(), queue_function_mem_write(), queue_function_memberpenalty_read(), queue_function_memberpenalty_write(), queue_function_queuegetchannel(), qupd_exec(), rcvfax_exec(), read_exec(), read_mf_exec(), read_sf_exec(), readexten_exec(), realtimefield_read(), receivefax_exec(), record_exec(), reg_source_db(), regex(), reload_single_member(), replace(), request(), retrydial_exec(), rqm_exec(), saycountedadj_exec(), saycountednoun_exec(), sayfile_exec(), sayunixtime_exec(), scramble_write(), senddtmf_exec(), sendfax_exec(), sendmf_exec(), sendurl_exec(), shared_read(), shared_write(), shift_pop(), sip_acf_channel_read(), sip_parse_register_line(), sip_request_call(), sla_trunk_exec(), smdi_msg_read(), smdi_msg_retrieve_read(), sms_exec(), sndfax_exec(), softhangup_exec(), sorcery_function_read(), speech_background(), speech_load(), srv_result_read(), stackpeek_read(), start_moh_exec(), start_monitor_exec(), statsd_exec(), stir_shaken_read(), stop_mixmonitor_full(), stream_echo_exec(), strreplace(), talk_detect_fn_write(), transfer_exec(), unicast_rtp_request(), unshift_push(), upqm_exec(), userevent_exec(), verbose_exec(), vm_check_password_shell(), vm_exec(), vm_execmain(), vm_playmsgexec(), volume_read(), volume_write(), wait_exec(), waitfor_exec(), xmpp_join_exec(), xmpp_leave_exec(), xmpp_send_exec(), xmpp_sendgroup_exec(), and zapateller_exec().

◆ AST_DEFINE_APP_ARGS_TYPE

#define AST_DEFINE_APP_ARGS_TYPE (   type,
  arglist 
)

Define a structure type to hold an application's arguments.

Parameters
typeThe name of the structure type
arglistThe list of arguments, defined using AST_APP_ARG

This macro defines a structure type intended to be used in a call to ast_app_separate_args(). The structure includes all the arguments specified, plus an argv array that overlays them and an argc argument counter. The arguments must be declared using AST_APP_ARG, and they will all be character pointers (strings).

Note
This defines a structure type, but does not declare an instance of the structure. That must be done separately.

Definition at line 1266 of file include/asterisk/app.h.

Referenced by reload().

◆ AST_IVR_DECLARE_MENU

#define AST_IVR_DECLARE_MENU (   holder,
  title,
  flags,
  foo... 
)
Value:
static struct ast_ivr_option __options_##holder[] = foo;\
static struct ast_ivr_menu holder = { title, flags, __options_##holder }
unsigned int flags

Definition at line 109 of file include/asterisk/app.h.

Referenced by ivr_demo_func().

◆ AST_IVR_FLAG_AUTORESTART

#define AST_IVR_FLAG_AUTORESTART   (1 << 0)

Definition at line 107 of file include/asterisk/app.h.

◆ AST_NONSTANDARD_APP_ARGS

#define AST_NONSTANDARD_APP_ARGS (   args,
  parse,
  sep 
)    args.argc = __ast_app_separate_args(parse, sep, 1, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))

Performs the 'nonstandard' argument separation process for an application.

Parameters
argsAn argument structure defined using AST_DECLARE_APP_ARGS
parseA modifiable buffer containing the input to be parsed
sepA nonstandard separator character

This function will separate the input string using the nonstandard argument separator character and fill in the provided structure, including the argc argument counter field.

Definition at line 1300 of file include/asterisk/app.h.

Referenced by acf_if(), acf_jabberreceive_read(), acf_jabberstatus_read(), agent_function_read(), aMYSQL_connect(), aMYSQL_fetch(), aMYSQL_nextresult(), aMYSQL_query(), aMYSQL_set(), ast_queue_log(), audiosocket_request(), build_profile(), callerid_read(), callerid_write(), connectedline_read(), connectedline_write(), dahdi_call(), determine_starting_point(), dialgroup_write(), function_db_delete(), function_db_exists(), function_db_read(), function_db_write(), jingle_request(), misdn_call(), misdn_request(), multicast_rtp_request(), my_on_hook(), oss_call(), oss_request(), pbx_builtin_setvar_multiple(), redirecting_read(), redirecting_write(), regex(), request(), sip_request_call(), unicast_rtp_request(), and vm_check_password_shell().

◆ AST_NONSTANDARD_RAW_ARGS

#define AST_NONSTANDARD_RAW_ARGS (   args,
  parse,
  sep 
)    args.argc = __ast_app_separate_args(parse, sep, 0, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))

◆ AST_STANDARD_APP_ARGS

#define AST_STANDARD_APP_ARGS (   args,
  parse 
)    args.argc = __ast_app_separate_args(parse, ',', 1, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))

Performs the 'standard' argument separation process for an application.

Parameters
argsAn argument structure defined using AST_DECLARE_APP_ARGS
parseA modifiable buffer containing the input to be parsed

This function will separate the input string using the standard argument separator character ',' and fill in the provided structure, including the argc argument counter field.

Definition at line 1285 of file include/asterisk/app.h.

Referenced by acf_abs_exec(), acf_curl_exec(), acf_curl_write(), acf_isexten_exec(), acf_jabberreceive_read(), acf_jabberstatus_read(), acf_max_exec(), acf_meetme_info(), acf_min_exec(), acf_odbc_read(), acf_odbc_write(), acf_rand_exec(), acf_sprintf(), acf_strftime(), acf_strptime(), acf_transaction_read(), acf_transaction_write(), acf_version_exec(), acf_vm_info(), acf_vmcount_exec(), action_status(), add_action_to_menu_entry(), admin_exec(), aes_helper(), agent_login_exec(), agent_request_exec(), agi_exec_full(), app_exec(), applicationmap_handler(), aqm_exec(), array(), ast_eivr_senddtmf(), asyncgoto_exec(), attended_transfer_exec(), audiosocket_exec(), auth_exec(), background_detect_exec(), blind_transfer_exec(), bridge_exec(), bridgewait_exec(), build_profile(), calendar_query_exec(), calendar_query_result_exec(), calendar_write_exec(), callerid_read(), callerid_write(), cb_events(), cdr_prop_write_callback(), cdr_read_callback(), cdr_write(), cdr_write_callback(), celgenuserevent_exec(), chanavail_exec(), channel_admin_exec(), channelvars_handler(), chanspy_exec(), cli_odbc_read(), cli_odbc_write(), conf_exec(), confbridge_exec(), config_function_read(), confkick_exec(), connectedline_write(), controlplayback_exec(), count_exec(), cut_internal(), destroy_all_channels(), detect_write(), dial_exec_full(), dialgroup_write(), dictate_exec(), directory_exec(), disa_exec(), dtmfstore_exec(), dundi_query_read(), dundi_result_read(), dundifunc_read(), enable_jack_hook(), enum_query_read(), enum_result_read(), execif_exec(), extenspy_exec(), festival_exec(), file_count_line(), file_read(), file_write(), find_conf(), find_realtime_gw(), find_table_cb(), forkcdr_exec(), func_confbridge_helper(), func_confbridge_info(), func_get_parkingslot_channel(), func_header_read(), func_headers_read2(), func_mixmonitor_read(), func_read_header(), func_write_header(), function_amiclient(), function_enum(), function_fieldnum_helper(), function_fieldqty_helper(), function_realtime_read(), function_realtime_readdestroy(), function_realtime_store(), function_realtime_write(), function_txtcidname(), hangupcause_read(), hash_read(), hash_write(), hint_read(), hook_on(), iconv_read(), import_helper(), init_acf_query(), isAnsweringMachine(), isexten_function_read(), jb_helper(), listfilter(), load_channelvars(), log_exec(), man_do_variable_value(), math(), mbl_sendsms_exec(), mbl_status_exec(), misdn_check_l2l1(), misdn_facility_exec(), mixmonitor_exec(), msg_send_exec(), originate_exec(), ospauth_exec(), ospfinished_exec(), osplookup_exec(), ospnext_exec(), page_exec(), park_and_announce_app_exec(), park_app_parse_data(), parked_call_app_exec(), pbx_builtin_answer(), pbx_builtin_background(), pbx_builtin_saycharacters_case(), pbx_builtin_setvar_multiple(), pbx_builtin_waitdigit(), pbx_builtin_waitexten(), pickupchan_exec(), pjsip_acf_channel_read(), pjsip_acf_dial_contacts_read(), pjsip_acf_parse_uri_read(), pjsip_aor_function_read(), pjsip_contact_function_read(), pjsip_endpoint_function_read(), play_moh_exec(), playback_exec(), pp_each_extension_helper(), pqm_exec(), presence_read(), privacy_exec(), ql_exec(), queue_exec(), queue_function_mem_read(), queue_function_mem_write(), queue_function_memberpenalty_read(), queue_function_memberpenalty_write(), queue_function_queuegetchannel(), qupd_exec(), rcvfax_exec(), read_exec(), read_mf_exec(), read_sf_exec(), readexten_exec(), realtimefield_read(), receivefax_exec(), record_exec(), redirecting_write(), reload(), reload_single_member(), replace(), retrydial_exec(), rqm_exec(), saycountedadj_exec(), saycountednoun_exec(), sayfile_exec(), sayunixtime_exec(), scramble_write(), senddtmf_exec(), sendfax_exec(), sendmf_exec(), sendurl_exec(), shared_read(), shared_write(), shift_pop(), sip_acf_channel_read(), sla_trunk_exec(), smdi_msg_read(), smdi_msg_retrieve_read(), sms_exec(), sndfax_exec(), softhangup_exec(), sorcery_function_read(), speech_background(), speech_load(), srv_result_read(), stackpeek_read(), start_moh_exec(), start_monitor_exec(), statsd_exec(), stir_shaken_read(), stop_mixmonitor_full(), stream_echo_exec(), strreplace(), talk_detect_fn_write(), transfer_exec(), unshift_push(), upqm_exec(), userevent_exec(), verbose_exec(), vm_exec(), vm_execmain(), vm_playmsgexec(), volume_read(), volume_write(), wait_exec(), waitfor_exec(), xmpp_join_exec(), xmpp_leave_exec(), xmpp_send_exec(), xmpp_sendgroup_exec(), and zapateller_exec().

◆ AST_STANDARD_RAW_ARGS

#define AST_STANDARD_RAW_ARGS (   args,
  parse 
)    args.argc = __ast_app_separate_args(parse, ',', 0, args.argv, ((sizeof(args) - offsetof(typeof(args), argv)) / sizeof(args.argv[0])))

◆ ast_vm_greeter_register

#define ast_vm_greeter_register (   vm_table)    __ast_vm_greeter_register(vm_table, AST_MODULE_SELF)

See __ast_vm_greeter_register()

Definition at line 657 of file include/asterisk/app.h.

Referenced by load_module().

◆ ast_vm_register

#define ast_vm_register (   vm_table)    __ast_vm_register(vm_table, AST_MODULE_SELF)

See __ast_vm_register()

Definition at line 588 of file include/asterisk/app.h.

Referenced by load_module().

◆ BEGIN_OPTIONS

#define BEGIN_OPTIONS   {

Definition at line 1343 of file include/asterisk/app.h.

◆ END_OPTIONS

#define END_OPTIONS   }

Definition at line 1344 of file include/asterisk/app.h.

◆ VM_GREETER_MODULE_VERSION

#define VM_GREETER_MODULE_VERSION   1
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 615 of file include/asterisk/app.h.

Referenced by __ast_vm_greeter_register().

◆ VM_MODULE_VERSION

#define VM_MODULE_VERSION   2
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 536 of file include/asterisk/app.h.

Referenced by __ast_vm_register().

Typedef Documentation

◆ ast_copy_recording_to_vm_fn

typedef int() ast_copy_recording_to_vm_fn(struct ast_vm_recording_data *vm_rec_data)

Creates a voicemail based on a specified file to a mailbox.

Parameters
vm_rec_dataA record containing filename and voicemail txt info.
Return values
0on success
-1on failure

Definition at line 414 of file include/asterisk/app.h.

◆ ast_has_voicemail_fn

typedef int() ast_has_voicemail_fn(const char *mailboxes, const char *folder)

Determines if the given folder has messages.

Parameters
mailboxesComma or & delimited list of mailboxes (user). If no context is found, uses 'default' for the context.
folderThe folder to look in. Default is INBOX if not provided.
Return values
1if the folder has one or more messages.
0otherwise.

Definition at line 344 of file include/asterisk/app.h.

◆ ast_inboxcount2_fn

typedef int() ast_inboxcount2_fn(const char *mailboxes, int *urgentmsgs, int *newmsgs, int *oldmsgs)

Gets the number of messages that exist for the mailbox list.

Parameters
mailboxesComma or space delimited list of mailboxes (user). If no context is found, uses 'default' for the context.
urgentmsgsWhere to put the count of urgent messages. (Can be NULL)
newmsgsWhere to put the count of new messages. (Can be NULL)
oldmsgsWhere to put the count of old messages. (Can be NULL)

Simultaneously determines the count of new, old, and urgent messages. The total messages would then be the sum of these three.

Return values
0on success
-1on failure

Definition at line 380 of file include/asterisk/app.h.

◆ ast_inboxcount_fn

typedef int() ast_inboxcount_fn(const char *mailboxes, int *newmsgs, int *oldmsgs)

Gets the number of messages that exist for the mailbox list.

Parameters
mailboxesComma or space delimited list of mailboxes (user). If no context is found, uses 'default' for the context.
newmsgsWhere to put the count of new messages. (Can be NULL)
oldmsgsWhere to put the count of old messages. (Can be NULL)

Simultaneously determines the count of new + urgent and old messages. The total messages would then be the sum of these.

Return values
0on success
-1on failure

Definition at line 361 of file include/asterisk/app.h.

◆ ast_ivr_callback

typedef int() ast_ivr_callback(struct ast_channel *chan, char *option, void *cbdata)

Callback function for IVR.

Returns
returns 0 on completion, -1 on hangup or digit if interrupted

Definition at line 47 of file include/asterisk/app.h.

◆ ast_messagecount_fn

typedef int() ast_messagecount_fn(const char *mailbox_id, const char *folder)

Gets the number of messages that exist in a mailbox folder.

Parameters
mailbox_idThe mailbox name.
folderThe folder to look in. Default is INBOX if not provided.
Note
If requesting INBOX then the returned count is INBOX + Urgent.
Returns
The number of messages in the mailbox folder (zero or more).

Definition at line 392 of file include/asterisk/app.h.

◆ ast_sayname_fn

typedef int() ast_sayname_fn(struct ast_channel *chan, const char *mailbox_id)

Play a recorded user name for the mailbox to the specified channel.

Parameters
chanWhere to play the recorded name file.
mailbox_idThe mailbox name.
Return values
0Name played without interruption
dtmfASCII value of the DTMF which interrupted playback.
-1Unable to locate mailbox or hangup occurred.

Definition at line 404 of file include/asterisk/app.h.

◆ ast_vm_index_to_foldername_fn

typedef const char*() ast_vm_index_to_foldername_fn(int id)

Convert the mailbox folder id to a folder name.

Parameters
idMailbox folder id to convert.
Deprecated:
Nothing calls it and nothing ever should.
Returns
The folder name associated with the id.

Definition at line 425 of file include/asterisk/app.h.

◆ ast_vm_mailbox_snapshot_create_fn

typedef struct ast_vm_mailbox_snapshot*() ast_vm_mailbox_snapshot_create_fn(const char *user, const char *context, const char *folder, int descending, enum ast_vm_snapshot_sort_val sort_val, int combine_INBOX_and_OLD)

Create a snapshot of a mailbox which contains information about every msg.

Parameters
userThe user part of user.
contextThe context part of user. Must be explicit.
folderWhen not NULL only msgs from the specified folder will be included.
descendinglist the msgs in descending order rather than ascending order.
sort_valWhat to sort in the snapshot.
combine_INBOX_and_OLDWhen this argument is set, The OLD folder will be represented in the INBOX folder of the snapshot. This allows the snapshot to represent the OLD and INBOX messages in sorted order merged together.
Note
Only used by voicemail unit tests.
Return values
snapshoton success
NULLon failure

Definition at line 444 of file include/asterisk/app.h.

◆ ast_vm_mailbox_snapshot_destroy_fn

typedef struct ast_vm_mailbox_snapshot*() ast_vm_mailbox_snapshot_destroy_fn(struct ast_vm_mailbox_snapshot *mailbox_snapshot)

destroy a snapshot

Parameters
mailbox_snapshotThe snapshot to destroy.
Note
Only used by voicemail unit tests.
Return values
NULL

Definition at line 457 of file include/asterisk/app.h.

◆ ast_vm_msg_forward_fn

typedef int() ast_vm_msg_forward_fn(const char *from_mailbox, const char *from_context, const char *from_folder, const char *to_mailbox, const char *to_context, const char *to_folder, size_t num_msgs, const char *msg_ids[], int delete_old)

forward a message from one mailbox to another.

from_mailbox The original mailbox the message is being forwarded from from_context The voicemail context of the from_mailbox from_folder The folder from which the message is being forwarded to_mailbox The mailbox to forward the message to to_context The voicemail context of the to_mailbox to_folder The folder to which the message is being forwarded num_msgs The number of messages being forwarded msg_ids The message IDs of the messages in from_mailbox to forward delete_old If non-zero, the forwarded messages are also deleted from from_mailbox. Otherwise, the messages will remain in the from_mailbox.

Note
Only used by voicemail unit tests.
Return values
-1Failure
0Success

Definition at line 514 of file include/asterisk/app.h.

◆ ast_vm_msg_move_fn

typedef int() ast_vm_msg_move_fn(const char *mailbox, const char *context, size_t num_msgs, const char *oldfolder, const char *old_msg_ids[], const char *newfolder)

Move messages from one folder to another.

Parameters
mailboxThe mailbox to which the folders belong
contextThe voicemail context for the mailbox
num_msgsThe number of messages to move
oldfolderThe folder from where messages should be moved
old_msg_idsThe message IDs of the messages to move
newfolderThe folder to which messages should be moved new folder. This array must be num_msgs sized.
Note
Only used by voicemail unit tests.
Return values
-1Failure
0Success

Definition at line 475 of file include/asterisk/app.h.

◆ ast_vm_msg_play_cb

typedef void() ast_vm_msg_play_cb(struct ast_channel *chan, const char *playfile, int duration)

Voicemail playback callback function definition.

Parameters
chanChannel to play the file back on.
playfileLocation of file on disk
durationof file in seconds. This will be zero if msg is very short or has an unknown duration.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 332 of file include/asterisk/app.h.

◆ ast_vm_msg_play_fn

typedef int() ast_vm_msg_play_fn(struct ast_channel *chan, const char *mailbox, const char *context, const char *folder, const char *msg_num, ast_vm_msg_play_cb *cb)

Play a voicemail msg back on a channel.

Parameters
chan
mailboxmsg is in.
contextof mailbox.
foldervoicemail folder to look in.
msg_nummessage number in the voicemailbox to playback to the channel.
cb
Note
Only used by voicemail unit tests.
Return values
0success
-1failure

Definition at line 533 of file include/asterisk/app.h.

◆ ast_vm_msg_remove_fn

typedef int() ast_vm_msg_remove_fn(const char *mailbox, const char *context, size_t num_msgs, const char *folder, const char *msgs[])

Remove/delete messages from a mailbox folder.

Parameters
mailboxThe mailbox from which to delete messages
contextThe voicemail context for the mailbox
num_msgsThe number of messages to delete
folderThe folder from which to remove messages
msgsThe message IDs of the messages to delete
Note
Only used by voicemail unit tests.
Return values
-1Failure
0Success

Definition at line 492 of file include/asterisk/app.h.

◆ ast_vm_test_create_user_fn

typedef int() ast_vm_test_create_user_fn(const char *context, const char *user)
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 670 of file include/asterisk/app.h.

◆ ast_vm_test_destroy_user_fn

typedef int() ast_vm_test_destroy_user_fn(const char *context, const char *user)
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 671 of file include/asterisk/app.h.

Enumeration Type Documentation

◆ ast_getdata_result

Enumerator
AST_GETDATA_FAILED 
AST_GETDATA_COMPLETE 
AST_GETDATA_TIMEOUT 
AST_GETDATA_INTERRUPTED 
AST_GETDATA_EMPTY_END_TERMINATED 

indicates a user terminated empty string rather than an empty string resulting from a timeout or other factors

Definition at line 1154 of file include/asterisk/app.h.

1154  {
1155  AST_GETDATA_FAILED = -1,
1157  AST_GETDATA_TIMEOUT = 1,
1159  /*! indicates a user terminated empty string rather than an empty string resulting
1160  * from a timeout or other factors */
1162 };

◆ ast_ivr_action

Enumerator
AST_ACTION_UPONE 

adata is unused

AST_ACTION_EXIT 

adata is the return value for ast_ivr_menu_run if channel was not hungup

AST_ACTION_CALLBACK 

adata is an ast_ivr_callback

AST_ACTION_PLAYBACK 

adata is file to play

AST_ACTION_BACKGROUND 

adata is file to play

AST_ACTION_PLAYLIST 

adata is list of files, separated by ; to play

AST_ACTION_MENU 

adata is a pointer to an ast_ivr_menu

AST_ACTION_REPEAT 

adata is max # of repeats, cast to a pointer

AST_ACTION_RESTART 

adata is like repeat, but resets repeats to 0

AST_ACTION_TRANSFER 

adata is a string with exten

[@context]
AST_ACTION_WAITOPTION 

adata is a timeout, or 0 for defaults

AST_ACTION_NOOP 

adata is unused

AST_ACTION_BACKLIST 

adata is list of files separated by ; allows interruption

Definition at line 49 of file include/asterisk/app.h.

49  {
50  AST_ACTION_UPONE, /*!< adata is unused */
51  AST_ACTION_EXIT, /*!< adata is the return value for ast_ivr_menu_run if channel was not hungup */
52  AST_ACTION_CALLBACK, /*!< adata is an ast_ivr_callback */
53  AST_ACTION_PLAYBACK, /*!< adata is file to play */
54  AST_ACTION_BACKGROUND, /*!< adata is file to play */
55  AST_ACTION_PLAYLIST, /*!< adata is list of files, separated by ; to play */
56  AST_ACTION_MENU, /*!< adata is a pointer to an ast_ivr_menu */
57  AST_ACTION_REPEAT, /*!< adata is max # of repeats, cast to a pointer */
58  AST_ACTION_RESTART, /*!< adata is like repeat, but resets repeats to 0 */
59  AST_ACTION_TRANSFER, /*!< adata is a string with exten\verbatim[@context]\endverbatim */
60  AST_ACTION_WAITOPTION, /*!< adata is a timeout, or 0 for defaults */
61  AST_ACTION_NOOP, /*!< adata is unused */
62  AST_ACTION_BACKLIST, /*!< adata is list of files separated by ; allows interruption */
ast_ivr_action

◆ AST_LOCK_RESULT

Enumerator
AST_LOCK_SUCCESS 
AST_LOCK_TIMEOUT 
AST_LOCK_PATH_NOT_FOUND 
AST_LOCK_FAILURE 

Definition at line 1164 of file include/asterisk/app.h.

◆ AST_LOCK_TYPE

Type of locking to use in ast_lock_path / ast_unlock_path.

Enumerator
AST_LOCK_TYPE_LOCKFILE 
AST_LOCK_TYPE_FLOCK 

Definition at line 1172 of file include/asterisk/app.h.

◆ ast_record_if_exists

Possible actions to take if a recording already exists

Since
12
Enumerator
AST_RECORD_IF_EXISTS_ERROR 

Return an Error State for IF_Exists

AST_RECORD_IF_EXISTS_FAIL 

Fail the recording.

AST_RECORD_IF_EXISTS_OVERWRITE 

Overwrite the existing recording.

AST_RECORD_IF_EXISTS_APPEND 

Append to the existing recording.

Definition at line 1072 of file include/asterisk/app.h.

1072  {
1073  /*! Return an Error State for IF_Exists */
1075  /*! Fail the recording. */
1077  /*! Overwrite the existing recording. */
1079  /*! Append to the existing recording. */
1081 };

◆ ast_timelen

Enumerator
TIMELEN_HOURS 
TIMELEN_MINUTES 
TIMELEN_SECONDS 
TIMELEN_MILLISECONDS 

Definition at line 113 of file include/asterisk/app.h.

◆ ast_vm_snapshot_sort_val

Enumerator
AST_VM_SNAPSHOT_SORT_BY_ID 
AST_VM_SNAPSHOT_SORT_BY_TIME 

Definition at line 295 of file include/asterisk/app.h.

Function Documentation

◆ __ast_app_separate_args()

unsigned int __ast_app_separate_args ( char *  buf,
char  delim,
int  remove_chars,
char **  array,
int  arraylen 
)

Separate a string into arguments in an array.

Parameters
bufThe string to be parsed (this must be a writable copy, as it will be modified)
delimThe character to be used to delimit arguments
remove_charsRemove backslashes and quote characters, while parsing
arrayAn array of 'char *' to be filled in with pointers to the found arguments
arraylenThe number of elements in the array (i.e. the number of arguments you will accept)

Note: if there are more arguments in the string than the array will hold, the last element of the array will contain the remaining arguments, not separated.

The array will be completely zeroed by this function before it populates any entries.

Returns
The number of arguments found, or zero if the function arguments are not valid.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2199 of file main/app.c.

References buf, NULL, paren, and quote().

2200 {
2201  int argc;
2202  char *scan, *wasdelim = NULL;
2203  int paren = 0, quote = 0, bracket = 0;
2204 
2205  if (!array || !arraylen) {
2206  return 0;
2207  }
2208 
2209  memset(array, 0, arraylen * sizeof(*array));
2210 
2211  if (!buf) {
2212  return 0;
2213  }
2214 
2215  scan = buf;
2216 
2217  for (argc = 0; *scan && (argc < arraylen - 1); argc++) {
2218  array[argc] = scan;
2219  for (; *scan; scan++) {
2220  if (*scan == '(') {
2221  paren++;
2222  } else if (*scan == ')') {
2223  if (paren) {
2224  paren--;
2225  }
2226  } else if (*scan == '[') {
2227  bracket++;
2228  } else if (*scan == ']') {
2229  if (bracket) {
2230  bracket--;
2231  }
2232  } else if (*scan == '"' && delim != '"') {
2233  quote = quote ? 0 : 1;
2234  if (remove_chars) {
2235  /* Remove quote character from argument */
2236  memmove(scan, scan + 1, strlen(scan));
2237  scan--;
2238  }
2239  } else if (*scan == '\\') {
2240  if (remove_chars) {
2241  /* Literal character, don't parse */
2242  memmove(scan, scan + 1, strlen(scan));
2243  } else {
2244  scan++;
2245  }
2246  } else if ((*scan == delim) && !paren && !quote && !bracket) {
2247  wasdelim = scan;
2248  *scan++ = '\0';
2249  break;
2250  }
2251  }
2252  }
2253 
2254  /* If the last character in the original string was the delimiter, then
2255  * there is one additional argument. */
2256  if (*scan || (scan > buf && (scan - 1) == wasdelim)) {
2257  array[argc++] = scan;
2258  }
2259 
2260  return argc;
2261 }
char buf[BUFSIZE]
Definition: eagi_proxy.c:66
#define NULL
Definition: resample.c:96
static int quote(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int array(struct ast_channel *chan, const char *cmd, char *var, const char *value)
#define paren
Definition: ael_lex.c:973

◆ __ast_vm_greeter_register()

int __ast_vm_greeter_register ( const struct ast_vm_greeter_functions vm_table,
struct ast_module module 
)

Set voicemail greeter function callbacks.

Since
13.0.0
Parameters
vm_tableVoicemail greeter function table to install.
modulePointer to the module implementing the interface
Return values
0on success.
-1on error.
AST_MODULE_LOAD_DECLINEif there's already another greeter registered.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 552 of file main/app.c.

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_alloc_options, ao2_cleanup, ao2_global_obj_ref, ao2_global_obj_replace_unref, ast_log, AST_MODULE_LOAD_DECLINE, LOG_ERROR, LOG_WARNING, ast_vm_greeter_functions::module, ast_vm_greeter_functions::module_name, ast_vm_greeter_functions::module_version, NULL, RAII_VAR, table, VM_GREETER_MODULE_VERSION, and vm_table.

553 {
555 
556  if (!vm_table->module_name) {
557  ast_log(LOG_ERROR, "Voicemail greeter provider missing required information.\n");
558  return -1;
559  }
560  if (vm_table->module_version != VM_GREETER_MODULE_VERSION) {
561  ast_log(LOG_ERROR, "Voicemail greeter provider '%s' has incorrect version\n",
562  vm_table->module_name);
563  return -1;
564  }
565 
566  table = ao2_global_obj_ref(vm_greeter_provider);
567  if (table) {
568  ast_log(LOG_WARNING, "Voicemail greeter provider already registered by %s.\n",
569  table->module_name);
571  }
572 
574  if (!table) {
575  return -1;
576  }
577  *table = *vm_table;
578  table->module = module;
579 
580  ao2_global_obj_replace_unref(vm_greeter_provider, table);
581  return 0;
582 }
unsigned int module_version
The version of this function table.
static const struct ast_vm_functions vm_table
#define LOG_WARNING
Definition: logger.h:274
Voicemail greeter function table definition.
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
#define VM_GREETER_MODULE_VERSION
#define ao2_alloc_options(data_size, destructor_fn, options)
Definition: astobj2.h:406
#define NULL
Definition: resample.c:96
static char * table
Definition: cdr_odbc.c:58
#define ast_log
Definition: astobj2.c:42
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
#define LOG_ERROR
Definition: logger.h:285
const char * module_name
The name of the module that provides the voicemail greeter functionality.
Module has failed to load, may be in an inconsistent state.
Definition: module.h:78
#define ao2_global_obj_replace_unref(holder, obj)
Definition: astobj2.h:908
#define ao2_cleanup(obj)
Definition: astobj2.h:1958

◆ __ast_vm_register()

int __ast_vm_register ( const struct ast_vm_functions vm_table,
struct ast_module module 
)

Set voicemail function callbacks.

Parameters
vm_tableVoicemail function table to install.
modulePointer to the module implementing the interface
Return values
0on success.
-1on error.
AST_MODULE_LOAD_DECLINEif there's already another provider registered.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 441 of file main/app.c.

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_alloc_options, ao2_cleanup, ao2_global_obj_ref, ao2_global_obj_replace_unref, ast_log, AST_MODULE_LOAD_DECLINE, LOG_ERROR, LOG_WARNING, ast_vm_functions::module, ast_vm_functions::module_name, ast_vm_functions::module_version, NULL, RAII_VAR, table, VM_MODULE_VERSION, and vm_table.

442 {
444 
445  if (!vm_table->module_name) {
446  ast_log(LOG_ERROR, "Voicemail provider missing required information.\n");
447  return -1;
448  }
449  if (vm_table->module_version != VM_MODULE_VERSION) {
450  ast_log(LOG_ERROR, "Voicemail provider '%s' has incorrect version\n",
451  vm_table->module_name);
452  return -1;
453  }
454 
455  table = ao2_global_obj_ref(vm_provider);
456  if (table) {
457  ast_log(LOG_WARNING, "Voicemail provider already registered by %s.\n",
458  table->module_name);
460  }
461 
463  if (!table) {
464  return -1;
465  }
466  *table = *vm_table;
467  table->module = module;
468 
469  ao2_global_obj_replace_unref(vm_provider, table);
470  return 0;
471 }
static const struct ast_vm_functions vm_table
#define LOG_WARNING
Definition: logger.h:274
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
#define ao2_alloc_options(data_size, destructor_fn, options)
Definition: astobj2.h:406
#define NULL
Definition: resample.c:96
static char * table
Definition: cdr_odbc.c:58
#define ast_log
Definition: astobj2.c:42
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
#define VM_MODULE_VERSION
#define LOG_ERROR
Definition: logger.h:285
Module has failed to load, may be in an inconsistent state.
Definition: module.h:78
const char * module_name
The name of the module that provides the voicemail functionality.
#define ao2_global_obj_replace_unref(holder, obj)
Definition: astobj2.h:908
#define ao2_cleanup(obj)
Definition: astobj2.h:1958
unsigned int module_version
The version of this function table.
Voicemail function table definition.

◆ app_init()

int app_init ( void  )

Initialize the application core.

Return values
0Success
-1Failure
Since
12
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3205 of file main/app.c.

References app_cleanup(), ast_register_cleanup(), child_cap, stasis_topic_create(), and stasis_topic_pool_create().

Referenced by asterisk_daemon().

3206 {
3208 #ifdef HAVE_CAP
3209  child_cap = cap_from_text("cap_net_admin-eip");
3210 #endif
3211  queue_topic_all = stasis_topic_create("queue:all");
3212  if (!queue_topic_all) {
3213  return -1;
3214  }
3216  if (!queue_topic_pool) {
3217  return -1;
3218  }
3219  return 0;
3220 }
static struct stasis_topic * queue_topic_all
Definition: main/app.c:90
static void app_cleanup(void)
Definition: main/app.c:3194
struct stasis_topic_pool * stasis_topic_pool_create(struct stasis_topic *pooled_topic)
Create a topic pool that routes messages from dynamically generated topics to the given topic...
Definition: stasis.c:1833
static struct stasis_topic_pool * queue_topic_pool
Definition: main/app.c:91
int ast_register_cleanup(void(*func)(void))
Register a function to be executed before Asterisk gracefully exits.
Definition: clicompat.c:19
struct stasis_topic * stasis_topic_create(const char *name)
Create a new topic.
Definition: stasis.c:618
static cap_t child_cap
Definition: main/app.c:85

◆ ast_app_copy_recording_to_vm()

int ast_app_copy_recording_to_vm ( struct ast_vm_recording_data vm_rec_data)

param[in] vm_rec_data Contains data needed to make the recording. retval 0 voicemail successfully created from recording. retval -1 Failure

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 669 of file main/app.c.

References VM_API_CALL.

Referenced by copy_to_voicemail().

670 {
671  int res = -1;
672 
673  VM_API_CALL(res, copy_recording_to_vm, (vm_rec_data));
674  return res;
675 }
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620

◆ ast_app_dtget()

int ast_app_dtget ( struct ast_channel chan,
const char *  context,
char *  collect,
size_t  size,
int  maxlen,
int  timeout 
)

Present a dialtone and collect a certain length extension.

Returns
Returns 1 on valid extension entered, -1 on hangup, or 0 on invalid extension.
Note
Note that if 'collect' holds digits already, new digits will be appended, so be sure it's initialized properly

Present a dialtone and collect a certain length extension.

Parameters
chanstruct.
context
collect
size
maxlen
timeouttimeout in milliseconds
Returns
0 if extension does not exist, 1 if extension exists
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 139 of file main/app.c.

References ast_channel_caller(), ast_channel_pbx(), ast_channel_zone(), ast_exists_extension(), ast_get_indication_tone(), ast_ignore_pattern(), ast_log, ast_matchmore_extension(), ast_playtones_start(), ast_playtones_stop(), ast_tone_zone_sound_unref(), ast_waitfordigit(), ast_tone_zone_sound::data, ast_pbx::dtimeoutms, LOG_NOTICE, NULL, and S_COR.

Referenced by grab_transfer().

140 {
141  struct ast_tone_zone_sound *ts;
142  int res = 0, x = 0;
143 
144  if (maxlen > size) {
145  maxlen = size;
146  }
147 
148  if (!timeout) {
149  if (ast_channel_pbx(chan) && ast_channel_pbx(chan)->dtimeoutms) {
151  } else {
152  timeout = 5000;
153  }
154  }
155 
156  if ((ts = ast_get_indication_tone(ast_channel_zone(chan), "dial"))) {
157  res = ast_playtones_start(chan, 0, ts->data, 0);
158  ts = ast_tone_zone_sound_unref(ts);
159  } else {
160  ast_log(LOG_NOTICE, "Huh....? no dial for indications?\n");
161  }
162 
163  for (x = strlen(collect); x < maxlen; ) {
164  res = ast_waitfordigit(chan, timeout);
165  if (!ast_ignore_pattern(context, collect)) {
166  ast_playtones_stop(chan);
167  }
168  if (res < 1) {
169  break;
170  }
171  if (res == '#') {
172  break;
173  }
174  collect[x++] = res;
175  if (!ast_matchmore_extension(chan, context, collect, 1,
176  S_COR(ast_channel_caller(chan)->id.number.valid, ast_channel_caller(chan)->id.number.str, NULL))) {
177  break;
178  }
179  }
180 
181  if (res >= 0) {
182  res = ast_exists_extension(chan, context, collect, 1,
183  S_COR(ast_channel_caller(chan)->id.number.valid, ast_channel_caller(chan)->id.number.str, NULL)) ? 1 : 0;
184  }
185 
186  return res;
187 }
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
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) ...
Definition: pbx.c:4199
static int timeout
Definition: cdr_mysql.c:86
struct ast_tone_zone * ast_channel_zone(const struct ast_channel *chan)
int ast_ignore_pattern(const char *context, const char *pattern)
Checks to see if a number should be ignored.
Definition: pbx.c:6921
void ast_playtones_stop(struct ast_channel *chan)
Stop playing tones on a channel.
Definition: indications.c:393
#define NULL
Definition: resample.c:96
Number structure.
Definition: app_followme.c:154
#define ast_log
Definition: astobj2.c:42
struct ast_pbx * ast_channel_pbx(const struct ast_channel *chan)
#define S_COR(a, b, c)
returns the equivalent of logic or for strings, with an additional boolean check: second one if not e...
Definition: strings.h:85
static struct ast_tone_zone_sound * ast_tone_zone_sound_unref(struct ast_tone_zone_sound *ts)
Release a reference to an ast_tone_zone_sound.
Definition: indications.h:227
int ast_exists_extension(struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
Determine whether an extension exists.
Definition: pbx.c:4179
Description of a tone.
Definition: indications.h:35
struct ast_tone_zone_sound * ast_get_indication_tone(const struct ast_tone_zone *zone, const char *indication)
Locate a tone zone sound.
Definition: indications.c:455
#define LOG_NOTICE
Definition: logger.h:263
int ast_waitfordigit(struct ast_channel *c, int ms)
Waits for a digit.
Definition: channel.c:3184
int dtimeoutms
Definition: pbx.h:212
int ast_playtones_start(struct ast_channel *chan, int vol, const char *tonelist, int interruptible)
Start playing a list of tones on a channel.
Definition: indications.c:302
const char * data
Description of a tone.
Definition: indications.h:52
static char context[AST_MAX_CONTEXT]
Definition: chan_alsa.c:116

◆ ast_app_exec_macro()

int ast_app_exec_macro ( struct ast_channel autoservice_chan,
struct ast_channel macro_chan,
const char *  macro_args 
)

Run a macro on a channel, placing an optional second channel into autoservice.

Since
11.0

This is a shorthand method that makes it very easy to run a macro on any given channel. It is perfectly reasonable to supply a NULL autoservice_chan here in case there is no channel to place into autoservice.

Note
Absolutely NO channel locks should be held before calling this function.
Parameters
autoservice_chanA channel to place into autoservice while the macro is run
macro_chanChannel to execute macro on.
macro_argsMacro application argument string.
Return values
0success
-1on error
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 273 of file main/app.c.

References ast_autoservice_start(), ast_autoservice_stop(), ast_channel_context(), ast_channel_exten(), ast_channel_name(), ast_channel_priority(), ast_check_hangup_locked(), ast_debug, ast_log, ast_queue_hangup(), LOG_WARNING, pbx_exec(), and pbx_findapp().

Referenced by ast_app_run_macro(), dial_exec_full(), generic_recall(), run_app_helper(), and try_calling().

274 {
275  struct ast_app *macro_app;
276  int res;
277 
278  macro_app = pbx_findapp("Macro");
279  if (!macro_app) {
281  "Cannot run 'Macro(%s)'. The application is not available.\n", macro_args);
282  return -1;
283  }
284  if (autoservice_chan) {
285  ast_autoservice_start(autoservice_chan);
286  }
287 
288  ast_debug(4, "%s Original location: %s,%s,%d\n", ast_channel_name(macro_chan),
289  ast_channel_context(macro_chan), ast_channel_exten(macro_chan),
290  ast_channel_priority(macro_chan));
291 
292  res = pbx_exec(macro_chan, macro_app, macro_args);
293  ast_debug(4, "Macro exited with status %d\n", res);
294 
295  /*
296  * Assume anything negative from Macro is an error.
297  * Anything else is success.
298  */
299  if (res < 0) {
300  res = -1;
301  } else {
302  res = 0;
303  }
304 
305  ast_debug(4, "%s Ending location: %s,%s,%d\n", ast_channel_name(macro_chan),
306  ast_channel_context(macro_chan), ast_channel_exten(macro_chan),
307  ast_channel_priority(macro_chan));
308 
309  if (autoservice_chan) {
310  ast_autoservice_stop(autoservice_chan);
311  }
312 
313  if (ast_check_hangup_locked(macro_chan)) {
314  ast_queue_hangup(macro_chan);
315  }
316 
317  return res;
318 }
int ast_queue_hangup(struct ast_channel *chan)
Queue a hangup frame.
Definition: channel.c:1150
int ast_autoservice_start(struct ast_channel *chan)
Automatically service a channel for us...
Definition: autoservice.c:200
int pbx_exec(struct ast_channel *c, struct ast_app *app, const char *data)
Execute an application.
Definition: pbx_app.c:471
int ast_check_hangup_locked(struct ast_channel *chan)
Definition: channel.c:459
#define LOG_WARNING
Definition: logger.h:274
int ast_channel_priority(const struct ast_channel *chan)
#define ast_debug(level,...)
Log a DEBUG message.
Definition: logger.h:452
#define ast_log
Definition: astobj2.c:42
const char * ast_channel_exten(const struct ast_channel *chan)
int ast_autoservice_stop(struct ast_channel *chan)
Stop servicing a channel for us...
Definition: autoservice.c:266
ast_app: A registered application
Definition: pbx_app.c:45
const char * ast_channel_name(const struct ast_channel *chan)
const char * ast_channel_context(const struct ast_channel *chan)
struct ast_app * pbx_findapp(const char *app)
Look up an application.
Definition: ael_main.c:165

◆ ast_app_exec_sub()

int ast_app_exec_sub ( struct ast_channel autoservice_chan,
struct ast_channel sub_chan,
const char *  sub_args,
int  ignore_hangup 
)

Run a subroutine on a channel, placing an optional second channel into autoservice.

Since
11

This is a shorthand method that makes it very easy to run a subroutine on any given channel. It is perfectly reasonable to supply a NULL autoservice_chan here in case there is no channel to place into autoservice.

Note
Absolutely NO channel locks should be held before calling this function.
Parameters
autoservice_chanA channel to place into autoservice while the subroutine is run
sub_chanChannel to execute subroutine on.
sub_argsGosub application argument string.
ignore_hangupTRUE if a hangup does not stop execution of the routine.
Return values
0success
-1on error
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 370 of file main/app.c.

References app_stack_callbacks, ast_autoservice_start(), ast_autoservice_stop(), ast_check_hangup_locked(), ast_log, ast_module_running_ref, ast_module_unref, ast_queue_hangup(), LOG_WARNING, ast_app_stack_funcs::module, and ast_app_stack_funcs::run_sub.

Referenced by app_exec(), ast_app_run_sub(), ast_pbx_hangup_handler_run(), ast_pre_call(), dial_exec_full(), generic_recall(), originate_exec(), page_exec(), queue_exec(), run_app_helper(), and try_calling().

371 {
372  const struct ast_app_stack_funcs *funcs;
373  int res;
374 
375  funcs = app_stack_callbacks;
376  if (!funcs || !funcs->run_sub || !ast_module_running_ref(funcs->module)) {
378  "Cannot run 'Gosub(%s)'. The app_stack module is not available.\n",
379  sub_args);
380  return -1;
381  }
382 
383  if (autoservice_chan) {
384  ast_autoservice_start(autoservice_chan);
385  }
386 
387  res = funcs->run_sub(sub_chan, sub_args, ignore_hangup);
388  ast_module_unref(funcs->module);
389 
390  if (autoservice_chan) {
391  ast_autoservice_stop(autoservice_chan);
392  }
393 
394  if (!ignore_hangup && ast_check_hangup_locked(sub_chan)) {
395  ast_queue_hangup(sub_chan);
396  }
397 
398  return res;
399 }
int ast_queue_hangup(struct ast_channel *chan)
Queue a hangup frame.
Definition: channel.c:1150
int ast_autoservice_start(struct ast_channel *chan)
Automatically service a channel for us...
Definition: autoservice.c:200
int ast_check_hangup_locked(struct ast_channel *chan)
Definition: channel.c:459
#define LOG_WARNING
Definition: logger.h:274
#define ast_module_unref(mod)
Release a reference to the module.
Definition: module.h:469
#define ast_log
Definition: astobj2.c:42
int ast_autoservice_stop(struct ast_channel *chan)
Stop servicing a channel for us...
Definition: autoservice.c:266
Stack applications callback functions.
static const struct ast_app_stack_funcs * app_stack_callbacks
Definition: main/app.c:344
int(* run_sub)(struct ast_channel *chan, const char *args, int ignore_hangup)
Callback for the routine to run a subroutine on a channel.
#define ast_module_running_ref(mod)
Hold a reference to the module if it is running.
Definition: module.h:455

◆ ast_app_expand_sub_args()

const char* ast_app_expand_sub_args ( struct ast_channel chan,
const char *  args 
)

Add missing context/exten to subroutine argument string.

Parameters
chanChannel to obtain context/exten.
argsGosub application argument string.

Fills in the optional context and exten from the given channel.

Return values
New-argsGosub argument string on success. Must be freed.
NULLon error.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 351 of file main/app.c.

References app_stack_callbacks, ast_log, ast_module_running_ref, ast_module_unref, ast_app_stack_funcs::expand_sub_args, LOG_WARNING, ast_app_stack_funcs::module, and NULL.

Referenced by app_exec(), ast_pbx_hangup_handler_push(), dial_exec_full(), and page_exec().

352 {
353  const struct ast_app_stack_funcs *funcs;
354  const char *new_args;
355 
356  funcs = app_stack_callbacks;
357  if (!funcs || !funcs->expand_sub_args || !ast_module_running_ref(funcs->module)) {
359  "Cannot expand 'Gosub(%s)' arguments. The app_stack module is not available.\n",
360  args);
361  return NULL;
362  }
363 
364  new_args = funcs->expand_sub_args(chan, args);
365  ast_module_unref(funcs->module);
366 
367  return new_args;
368 }
#define LOG_WARNING
Definition: logger.h:274
const char * args
#define NULL
Definition: resample.c:96
#define ast_module_unref(mod)
Release a reference to the module.
Definition: module.h:469
#define ast_log
Definition: astobj2.c:42
Stack applications callback functions.
static const struct ast_app_stack_funcs * app_stack_callbacks
Definition: main/app.c:344
#define ast_module_running_ref(mod)
Hold a reference to the module if it is running.
Definition: module.h:455
const char *(* expand_sub_args)(struct ast_channel *chan, const char *args)
Add missing context/exten to Gosub application argument string.

◆ ast_app_getdata()

int ast_app_getdata ( struct ast_channel c,
const char *  prompt,
char *  s,
int  maxlen,
int  timeout 
)

Plays a stream and gets DTMF data from a channel.

Parameters
cWhich channel one is interacting with
promptFile to pass to ast_streamfile (the one that you wish to play). It is also valid for this to be multiple files concatenated by "&". For example, "file1&file2&file3".
sThe location where the DTMF data will be stored
maxlenMax Length of the data
timeoutTimeout length waiting for data(in milliseconds). Set to 0 for standard timeout(six seconds), or -1 for no time out.

This function was designed for application programmers for situations where they need to play a message and then get some DTMF data in response to the message. If a digit is pressed during playback, it will immediately break out of the message and continue execution of your code.

Plays a stream and gets DTMF data from a channel.

Parameters
cThe channel to read from
promptThe file to stream to the channel
sThe string to read in to. Must be at least the size of your length
maxlenHow many digits to read (maximum)
timeoutset timeout to 0 for "standard" timeouts. Set timeout to -1 for "ludicrous time" (essentially never times out)
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 197 of file main/app.c.

References ast_channel_language(), ast_channel_pbx(), AST_GETDATA_EMPTY_END_TERMINATED, ast_readstring(), ast_strdupa, ast_streamfile(), ast_strlen_zero, ast_pbx::dtimeoutms, ast_pbx::rtimeoutms, strsep(), and timeout.

Referenced by auth_exec(), conf_exec(), conf_get_pin(), dictate_exec(), find_conf(), read_exec(), testclient_exec(), testserver_exec(), and vm_exec().

198 {
199  int res = 0, to, fto;
200  char *front, *filename;
201 
202  /* XXX Merge with full version? XXX */
203 
204  if (maxlen)
205  s[0] = '\0';
206 
207  if (!prompt)
208  prompt = "";
209 
210  filename = ast_strdupa(prompt);
211  while ((front = strsep(&filename, "&"))) {
212  if (!ast_strlen_zero(front)) {
213  res = ast_streamfile(c, front, ast_channel_language(c));
214  if (res)
215  continue;
216  }
217  if (ast_strlen_zero(filename)) {
218  /* set timeouts for the last prompt */
219  fto = ast_channel_pbx(c) ? ast_channel_pbx(c)->rtimeoutms : 6000;
220  to = ast_channel_pbx(c) ? ast_channel_pbx(c)->dtimeoutms : 2000;
221 
222  if (timeout > 0) {
223  fto = to = timeout;
224  }
225  if (timeout < 0) {
226  fto = to = 1000000000;
227  }
228  } else {
229  /* there is more than one prompt, so
230  * get rid of the long timeout between
231  * prompts, and make it 50ms */
232  fto = 50;
233  to = ast_channel_pbx(c) ? ast_channel_pbx(c)->dtimeoutms : 2000;
234  }
235  res = ast_readstring(c, s, maxlen, to, fto, "#");
237  return res;
238  }
239  if (!ast_strlen_zero(s)) {
240  return res;
241  }
242  }
243 
244  return res;
245 }
int ast_streamfile(struct ast_channel *c, const char *filename, const char *preflang)
Streams a file.
Definition: file.c:1250
static int timeout
Definition: cdr_mysql.c:86
#define ast_strlen_zero(foo)
Definition: strings.h:52
struct ast_pbx * ast_channel_pbx(const struct ast_channel *chan)
#define ast_strdupa(s)
duplicate a string in memory from the stack
Definition: astmm.h:300
char * strsep(char **str, const char *delims)
int dtimeoutms
Definition: pbx.h:212
const char * ast_channel_language(const struct ast_channel *chan)
static struct ast_str * prompt
Definition: asterisk.c:2725
int ast_readstring(struct ast_channel *c, char *s, int len, int timeout, int rtimeout, char *enders)
Reads multiple digits.
Definition: channel.c:6655
int rtimeoutms
Definition: pbx.h:213

◆ ast_app_getdata_full()

int ast_app_getdata_full ( struct ast_channel c,
const char *  prompt,
char *  s,
int  maxlen,
int  timeout,
int  audiofd,
int  ctrlfd 
)

Full version with audiofd and controlfd. NOTE: returns '2' on ctrlfd available, not '1' like other full functions.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 250 of file main/app.c.

References ast_channel_language(), ast_readstring_full(), ast_streamfile(), ast_strlen_zero, and timeout.

Referenced by handle_getdata().

251 {
252  int res, to = 2000, fto = 6000;
253 
254  if (!ast_strlen_zero(prompt)) {
256  if (res < 0) {
257  return res;
258  }
259  }
260 
261  if (timeout > 0) {
262  fto = to = timeout;
263  }
264  if (timeout < 0) {
265  fto = to = 1000000000;
266  }
267 
268  res = ast_readstring_full(c, s, maxlen, to, fto, "#", audiofd, ctrlfd);
269 
270  return res;
271 }
int ast_streamfile(struct ast_channel *c, const char *filename, const char *preflang)
Streams a file.
Definition: file.c:1250
static int timeout
Definition: cdr_mysql.c:86
#define ast_strlen_zero(foo)
Definition: strings.h:52
int ast_readstring_full(struct ast_channel *c, char *s, int len, int timeout, int rtimeout, char *enders, int audiofd, int ctrlfd)
Definition: channel.c:6660
const char * ast_channel_language(const struct ast_channel *chan)
static struct ast_str * prompt
Definition: asterisk.c:2725

◆ ast_app_group_discard()

int ast_app_group_discard ( struct ast_channel chan)

Discard all group counting for a channel.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2162 of file main/app.c.

References ast_free, AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_group_info::chan, ast_group_info::group_list, and NULL.

Referenced by ast_channel_destructor().

2163 {
2164  struct ast_group_info *gi = NULL;
2165 
2168  if (gi->chan == chan) {
2170  ast_free(gi);
2171  }
2172  }
2175 
2176  return 0;
2177 }
channel group info
Definition: channel.h:2938
#define AST_RWLIST_WRLOCK(head)
Write locks a list.
Definition: linkedlists.h:51
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define NULL
Definition: resample.c:96
#define AST_RWLIST_REMOVE_CURRENT
Definition: linkedlists.h:569
#define AST_RWLIST_TRAVERSE_SAFE_BEGIN
Definition: linkedlists.h:544
struct ast_channel * chan
Definition: channel.h:2939
#define ast_free(a)
Definition: astmm.h:182
struct ast_group_info::@248 group_list
#define AST_RWLIST_TRAVERSE_SAFE_END
Definition: linkedlists.h:616

◆ ast_app_group_get_count()

int ast_app_group_get_count ( const char *  group,
const char *  category 
)

Get the current channel count of the specified group and category.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2083 of file main/app.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strlen_zero, ast_group_info::category, ast_group_info::group, ast_group_info::group_list, and NULL.

Referenced by group_count_function_read().

2084 {
2085  struct ast_group_info *gi = NULL;
2086  int count = 0;
2087 
2088  if (ast_strlen_zero(group)) {
2089  return 0;
2090  }
2091 
2094  if (!strcasecmp(gi->group, group) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
2095  count++;
2096  }
2097  }
2099 
2100  return count;
2101 }
channel group info
Definition: channel.h:2938
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define NULL
Definition: resample.c:96
#define ast_strlen_zero(foo)
Definition: strings.h:52
#define AST_RWLIST_RDLOCK(head)
Read locks a list.
Definition: linkedlists.h:77
#define AST_RWLIST_TRAVERSE
Definition: linkedlists.h:493
char * group
Definition: channel.h:2941
char * category
Definition: channel.h:2940
struct ast_group_info::@248 group_list

◆ ast_app_group_list_head()

struct ast_group_info* ast_app_group_list_head ( void  )

Get the head of the group count list.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2189 of file main/app.c.

References AST_RWLIST_FIRST.

Referenced by group_count_function_read(), group_function_read(), group_list_function_read(), and group_show_channels().

2190 {
2191  return AST_RWLIST_FIRST(&groups);
2192 }
#define AST_RWLIST_FIRST
Definition: linkedlists.h:422

◆ ast_app_group_list_rdlock()

int ast_app_group_list_rdlock ( void  )

Read Lock the group count list.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2184 of file main/app.c.

References AST_RWLIST_RDLOCK.

Referenced by group_count_function_read(), group_function_read(), group_list_function_read(), and group_show_channels().

2185 {
2186  return AST_RWLIST_RDLOCK(&groups);
2187 }
#define AST_RWLIST_RDLOCK(head)
Read locks a list.
Definition: linkedlists.h:77

◆ ast_app_group_list_unlock()

int ast_app_group_list_unlock ( void  )

Unlock the group count list.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2194 of file main/app.c.

References AST_RWLIST_UNLOCK.

Referenced by group_count_function_read(), group_function_read(), group_list_function_read(), and group_show_channels().

2195 {
2196  return AST_RWLIST_UNLOCK(&groups);
2197 }
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150

◆ ast_app_group_list_wrlock()

int ast_app_group_list_wrlock ( void  )

Write Lock the group count list.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2179 of file main/app.c.

References AST_RWLIST_WRLOCK.

2180 {
2181  return AST_RWLIST_WRLOCK(&groups);
2182 }
#define AST_RWLIST_WRLOCK(head)
Write locks a list.
Definition: linkedlists.h:51

◆ ast_app_group_match_get_count()

int ast_app_group_match_get_count ( const char *  groupmatch,
const char *  category 
)

Get the current channel count of all groups that match the specified pattern and category.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2103 of file main/app.c.

References ast_log, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strlen_zero, ast_group_info::category, ast_group_info::group, ast_group_info::group_list, LOG_ERROR, LOG_NOTICE, and NULL.

Referenced by AST_TEST_DEFINE(), and group_match_count_function_read().

2104 {
2105  struct ast_group_info *gi = NULL;
2106  regex_t regexbuf_group;
2107  regex_t regexbuf_category;
2108  int count = 0;
2109 
2110  if (ast_strlen_zero(groupmatch)) {
2111  ast_log(LOG_NOTICE, "groupmatch empty\n");
2112  return 0;
2113  }
2114 
2115  /* if regex compilation fails, return zero matches */
2116  if (regcomp(&regexbuf_group, groupmatch, REG_EXTENDED | REG_NOSUB)) {
2117  ast_log(LOG_ERROR, "Regex compile failed on: %s\n", groupmatch);
2118  return 0;
2119  }
2120 
2121  if (!ast_strlen_zero(category) && regcomp(&regexbuf_category, category, REG_EXTENDED | REG_NOSUB)) {
2122  ast_log(LOG_ERROR, "Regex compile failed on: %s\n", category);
2123  regfree(&regexbuf_group);
2124  return 0;
2125  }
2126 
2129  if (!regexec(&regexbuf_group, gi->group, 0, NULL, 0) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !regexec(&regexbuf_category, gi->category, 0, NULL, 0)))) {
2130  count++;
2131  }
2132  }
2134 
2135  regfree(&regexbuf_group);
2136  if (!ast_strlen_zero(category)) {
2137  regfree(&regexbuf_category);
2138  }
2139 
2140  return count;
2141 }
channel group info
Definition: channel.h:2938
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define NULL
Definition: resample.c:96
#define ast_strlen_zero(foo)
Definition: strings.h:52
#define AST_RWLIST_RDLOCK(head)
Read locks a list.
Definition: linkedlists.h:77
#define ast_log
Definition: astobj2.c:42
#define AST_RWLIST_TRAVERSE
Definition: linkedlists.h:493
char * group
Definition: channel.h:2941
#define LOG_ERROR
Definition: logger.h:285
#define LOG_NOTICE
Definition: logger.h:263
char * category
Definition: channel.h:2940
struct ast_group_info::@248 group_list

◆ ast_app_group_set_channel()

int ast_app_group_set_channel ( struct ast_channel chan,
const char *  data 
)

Set the group for a channel, splitting the provided data into group and category, if specified.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2036 of file main/app.c.

References ast_app_group_split_group(), ast_calloc, ast_free, AST_RWLIST_INSERT_TAIL, AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_strlen_zero, ast_group_info::category, ast_group_info::chan, ast_group_info::group, ast_group_info::group_list, len(), and NULL.

Referenced by AST_TEST_DEFINE(), dial_exec_full(), and group_function_write().

2037 {
2038  int res = 0;
2039  char group[80] = "", category[80] = "";
2040  struct ast_group_info *gi = NULL;
2041  size_t len = 0;
2042 
2043  if (ast_app_group_split_group(data, group, sizeof(group), category, sizeof(category))) {
2044  return -1;
2045  }
2046 
2047  /* Calculate memory we will need if this is new */
2048  len = sizeof(*gi) + strlen(group) + 1;
2049  if (!ast_strlen_zero(category)) {
2050  len += strlen(category) + 1;
2051  }
2052 
2055  if ((gi->chan == chan) && ((ast_strlen_zero(category) && ast_strlen_zero(gi->category)) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
2057  ast_free(gi);
2058  break;
2059  }
2060  }
2062 
2063  if (ast_strlen_zero(group)) {
2064  /* Enable unsetting the group */
2065  } else if ((gi = ast_calloc(1, len))) {
2066  gi->chan = chan;
2067  gi->group = (char *) gi + sizeof(*gi);
2068  strcpy(gi->group, group);
2069  if (!ast_strlen_zero(category)) {
2070  gi->category = (char *) gi + sizeof(*gi) + strlen(group) + 1;
2071  strcpy(gi->category, category);
2072  }
2074  } else {
2075  res = -1;
2076  }
2077 
2079 
2080  return res;
2081 }
channel group info
Definition: channel.h:2938
#define AST_RWLIST_WRLOCK(head)
Write locks a list.
Definition: linkedlists.h:51
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define NULL
Definition: resample.c:96
#define ast_strlen_zero(foo)
Definition: strings.h:52
#define AST_RWLIST_REMOVE_CURRENT
Definition: linkedlists.h:569
char * group
Definition: channel.h:2941
#define AST_RWLIST_TRAVERSE_SAFE_BEGIN
Definition: linkedlists.h:544
struct ast_channel * chan
Definition: channel.h:2939
int ast_app_group_split_group(const char *data, char *group, int group_max, char *category, int category_max)
Split a group string into group and category, returning a default category if none is provided...
Definition: main/app.c:2009
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
#define ast_free(a)
Definition: astmm.h:182
#define ast_calloc(num, len)
A wrapper for calloc()
Definition: astmm.h:204
char * category
Definition: channel.h:2940
#define AST_RWLIST_INSERT_TAIL
Definition: linkedlists.h:740
struct ast_group_info::@248 group_list
#define AST_RWLIST_TRAVERSE_SAFE_END
Definition: linkedlists.h:616

◆ ast_app_group_split_group()

int ast_app_group_split_group ( const char *  data,
char *  group,
int  group_max,
char *  category,
int  category_max 
)

Split a group string into group and category, returning a default category if none is provided.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2009 of file main/app.c.

References ast_copy_string(), ast_strlen_zero, NULL, and tmp().

Referenced by ast_app_group_set_channel(), group_count_function_read(), and group_match_count_function_read().

2010 {
2011  int res = 0;
2012  char tmp[256];
2013  char *grp = NULL, *cat = NULL;
2014 
2015  if (!ast_strlen_zero(data)) {
2016  ast_copy_string(tmp, data, sizeof(tmp));
2017  grp = tmp;
2018  if ((cat = strchr(tmp, '@'))) {
2019  *cat++ = '\0';
2020  }
2021  }
2022 
2023  if (!ast_strlen_zero(grp)) {
2024  ast_copy_string(group, grp, group_max);
2025  } else {
2026  *group = '\0';
2027  }
2028 
2029  if (!ast_strlen_zero(cat)) {
2030  ast_copy_string(category, cat, category_max);
2031  }
2032 
2033  return res;
2034 }
static int tmp()
Definition: bt_open.c:389
#define NULL
Definition: resample.c:96
#define ast_strlen_zero(foo)
Definition: strings.h:52
char * category
Definition: channel.h:2940
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401

◆ ast_app_group_update()

int ast_app_group_update ( struct ast_channel oldchan,
struct ast_channel newchan 
)

Update all group counting for a channel to a new one.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2143 of file main/app.c.

References ast_free, AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_group_info::chan, ast_group_info::group_list, and NULL.

Referenced by channel_do_masquerade().

2144 {
2145  struct ast_group_info *gi = NULL;
2146 
2149  if (gi->chan == old) {
2150  gi->chan = new;
2151  } else if (gi->chan == new) {
2153  ast_free(gi);
2154  }
2155  }
2158 
2159  return 0;
2160 }
channel group info
Definition: channel.h:2938
#define AST_RWLIST_WRLOCK(head)
Write locks a list.
Definition: linkedlists.h:51
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define NULL
Definition: resample.c:96
#define AST_RWLIST_REMOVE_CURRENT
Definition: linkedlists.h:569
#define AST_RWLIST_TRAVERSE_SAFE_BEGIN
Definition: linkedlists.h:544
struct ast_channel * chan
Definition: channel.h:2939
#define ast_free(a)
Definition: astmm.h:182
struct ast_group_info::@248 group_list
#define AST_RWLIST_TRAVERSE_SAFE_END
Definition: linkedlists.h:616

◆ ast_app_has_voicemail()

int ast_app_has_voicemail ( const char *  mailboxes,
const char *  folder 
)

Determine if a given mailbox has any voicemail If folder is NULL, defaults to "INBOX". If folder is "INBOX", includes the number of messages in the "Urgent" folder.

Return values
1Mailbox has voicemail
0No new voicemail in specified mailbox
-1Failure
Since
1.0
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 655 of file main/app.c.

References has_voicemail(), and VM_API_CALL.

Referenced by action_mailboxstatus(), AST_TEST_DEFINE(), has_voicemail(), mwi_update_cb(), notify_new_message(), play_dialtone(), poll_mailbox(), run_externnotify(), skinny_register(), and unistim_send_mwi_to_peer().

656 {
657  int res = 0;
658 
659  VM_API_CALL(res, has_voicemail, (mailboxes, folder));
660  return res;
661 }
static struct stasis_rest_handlers mailboxes
REST handler for /api-docs/mailboxes.json.
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620
static int has_voicemail(const char *mailbox, const char *folder)
Determines if the given folder has messages.

◆ ast_app_inboxcount()

int ast_app_inboxcount ( const char *  mailboxes,
int *  newmsgs,
int *  oldmsgs 
)

Determine number of new/old messages in a mailbox.

Since
1.0
Parameters
[in]mailboxesMailbox specification in the format /code mbox[@context][&mbox2[@context2]][...] /code
[out]newmsgsNumber of messages in the "INBOX" folder. Includes number of messages in the "Urgent" folder, if any.
[out]oldmsgsNumber of messages in the "Old" folder.
Return values
0Success
-1Failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 677 of file main/app.c.

References inboxcount(), and VM_API_CALL.

Referenced by AST_TEST_DEFINE(), sip_send_mwi_to_peer(), and update_registry().

678 {
679  int res = 0;
680 
681  if (newmsgs) {
682  *newmsgs = 0;
683  }
684  if (oldmsgs) {
685  *oldmsgs = 0;
686  }
687 
688  VM_API_CALL(res, inboxcount, (mailboxes, newmsgs, oldmsgs));
689  return res;
690 }
static struct stasis_rest_handlers mailboxes
REST handler for /api-docs/mailboxes.json.
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620
static int inboxcount(const char *mailbox, int *newmsgs, int *oldmsgs)

◆ ast_app_inboxcount2()

int ast_app_inboxcount2 ( const char *  mailboxes,
int *  urgentmsgs,
int *  newmsgs,
int *  oldmsgs 
)

Determine number of urgent/new/old messages in a mailbox.

Parameters
[in]mailboxesthe mailbox context to use
[out]urgentmsgsthe urgent message count
[out]newmsgsthe new message count
[out]oldmsgsthe old message count
Returns
Returns 0 for success, negative upon error
Since
1.6.1
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 692 of file main/app.c.

References inboxcount2(), and VM_API_CALL.

Referenced by action_mailboxcount(), AST_TEST_DEFINE(), mwi_retrieve_then_create_state(), notify_new_message(), notify_new_state(), and vm_execmain().

693 {
694  int res = 0;
695 
696  if (newmsgs) {
697  *newmsgs = 0;
698  }
699  if (oldmsgs) {
700  *oldmsgs = 0;
701  }
702  if (urgentmsgs) {
703  *urgentmsgs = 0;
704  }
705 
706  VM_API_CALL(res, inboxcount2, (mailboxes, urgentmsgs, newmsgs, oldmsgs));
707  return res;
708 }
static struct stasis_rest_handlers mailboxes
REST handler for /api-docs/mailboxes.json.
static int inboxcount2(const char *mailbox, int *urgentmsgs, int *newmsgs, int *oldmsgs)
Check the given mailbox&#39;s message count.
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620

◆ ast_app_messagecount()

int ast_app_messagecount ( const char *  mailbox_id,
const char *  folder 
)

Get the number of messages in a given mailbox folder.

Parameters
[in]mailbox_idMailbox name
[in]folderThe folder to look in. Default is INBOX if not provided.
Note
If requesting INBOX then the returned count is INBOX + Urgent.
Returns
The number of messages in the mailbox folder (zero or more).
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 718 of file main/app.c.

References messagecount(), and VM_API_CALL.

Referenced by acf_vmcount_exec(), and AST_TEST_DEFINE().

719 {
720  int res = 0;
721 
722  VM_API_CALL(res, messagecount, (mailbox_id, folder));
723  return res;
724 }
static int messagecount(const char *mailbox_id, const char *folder)
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620

◆ ast_app_options2str64()

void ast_app_options2str64 ( const struct ast_app_option options,
struct ast_flags64 flags,
char *  buf,
size_t  len 
)

Given a list of options array, return an option string based on passed flags.

Parameters
optionsThe array of possible options declared with AST_APP_OPTIONS
flagsThe flags of the options that you wish to populate the buffer with
bufThe buffer to fill with the string of options
lenThe maximum length of buf
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2916 of file main/app.c.

References ast_test_flag64, and len().

2917 {
2918  unsigned int i, found = 0;
2919  for (i = 32; i < 128 && found < len; i++) {
2920  if (ast_test_flag64(flags, options[i].flag)) {
2921  buf[found++] = i;
2922  }
2923  }
2924  buf[found] = '\0';
2925 }
char buf[BUFSIZE]
Definition: eagi_proxy.c:66
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
long int flag
Definition: f2c.h:83
#define ast_test_flag64(p, flag)
Definition: utils.h:120

◆ ast_app_parse_options()

int ast_app_parse_options ( const struct ast_app_option options,
struct ast_flags flags,
char **  args,
char *  optstr 
)

Parses a string containing application options and sets flags/arguments.

Parameters
optionsThe array of possible options declared with AST_APP_OPTIONS
flagsThe flag structure to have option flags set
argsThe array of argument pointers to hold arguments found
optstrThe string containing the options to be parsed
Returns
zero for success, non-zero if an error occurs
See also
AST_APP_OPTIONS
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2906 of file main/app.c.

References parse_options().

Referenced by agent_login_exec(), app_exec(), ast_multicast_rtp_create_options(), AST_TEST_DEFINE(), audiosocket_request(), auth_exec(), bridge_exec(), bridgewait_exec(), cdr_read_callback(), cdr_write_callback(), chanspy_exec(), connectedline_write(), controlplayback_exec(), detect_write(), directory_exec(), disa_exec(), dundi_query_read(), dundifunc_read(), extenspy_exec(), forkcdr_exec(), handle_options(), hint_read(), manager_mixmonitor(), minivm_accmess_exec(), minivm_greet_exec(), minivm_record_exec(), mixmonitor_exec(), page_exec(), park_app_parse_data(), pbx_builtin_background(), pbx_builtin_waitexten(), pickupchan_exec(), queue_exec(), read_exec(), read_mf_exec(), read_sf_exec(), readexten_exec(), realtime_common(), receivefax_exec(), record_exec(), redirecting_write(), resetcdr_exec(), sendfax_exec(), sendurl_exec(), sla_trunk_exec(), smdi_msg_retrieve_read(), sms_exec(), softhangup_exec(), speech_background(), start_monitor_exec(), unicast_rtp_request(), vm_exec(), vm_execmain(), volume_write(), and wait_exec().

2907 {
2908  return parse_options(options, flags, args, optstr, 32);
2909 }
const char * args
static int parse_options(const struct ast_app_option *options, void *_flags, char **args, char *optstr, int flaglen)
Definition: main/app.c:2826

◆ ast_app_parse_options64()

int ast_app_parse_options64 ( const struct ast_app_option options,
struct ast_flags64 flags,
char **  args,
char *  optstr 
)

Parses a string containing application options and sets flags/arguments.

Parameters
optionsThe array of possible options declared with AST_APP_OPTIONS
flagsThe 64-bit flag structure to have option flags set
argsThe array of argument pointers to hold arguments found
optstrThe string containing the options to be parsed
Returns
zero for success, non-zero if an error occurs
See also
AST_APP_OPTIONS
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2911 of file main/app.c.

References parse_options().

Referenced by AST_TEST_DEFINE(), conf_exec(), dial_exec_full(), find_conf_realtime(), originate_exec(), and sayunixtime_exec().

2912 {
2913  return parse_options(options, flags, args, optstr, 64);
2914 }
const char * args
static int parse_options(const struct ast_app_option *options, void *_flags, char **args, char *optstr, int flaglen)
Definition: main/app.c:2826

◆ ast_app_parse_timelen()

int ast_app_parse_timelen ( const char *  timestr,
int *  result,
enum ast_timelen  defunit 
)

Common routine to parse time lengths, with optional time unit specifier.

Parameters
[in]timestrString to parse
[in]defunitDefault unit type
[out]resultResulting value, specified in milliseconds
Return values
0Success
-1Failure
Since
1.8
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3113 of file main/app.c.

References FMT, TIMELEN_HOURS, TIMELEN_MILLISECONDS, TIMELEN_MINUTES, and TIMELEN_SECONDS.

Referenced by ast_eivr_senddtmf(), ast_parse_arg(), new_realtime_sqlite3_db(), pbx_builtin_wait(), pbx_builtin_waitdigit(), pbx_builtin_waitexten(), senddtmf_exec(), and sendmf_exec().

3114 {
3115  int res;
3116  char u[10];
3117 #ifdef HAVE_LONG_DOUBLE_WIDER
3118  long double amount;
3119  #define FMT "%30Lf%9s"
3120 #else
3121  double amount;
3122  #define FMT "%30lf%9s"
3123 #endif
3124  if (!timestr) {
3125  return -1;
3126  }
3127 
3128  res = sscanf(timestr, FMT, &amount, u);
3129 
3130  if (res == 0 || res == EOF) {
3131 #undef FMT
3132  return -1;
3133  } else if (res == 2) {
3134  switch (u[0]) {
3135  case 'h':
3136  case 'H':
3137  unit = TIMELEN_HOURS;
3138  if (u[1] != '\0') {
3139  return -1;
3140  }
3141  break;
3142  case 's':
3143  case 'S':
3144  unit = TIMELEN_SECONDS;
3145  if (u[1] != '\0') {
3146  return -1;
3147  }
3148  break;
3149  case 'm':
3150  case 'M':
3151  if (toupper(u[1]) == 'S') {
3152  unit = TIMELEN_MILLISECONDS;
3153  if (u[2] != '\0') {
3154  return -1;
3155  }
3156  } else if (u[1] == '\0') {
3157  unit = TIMELEN_MINUTES;
3158  } else {
3159  return -1;
3160  }
3161  break;
3162  default:
3163  return -1;
3164  }
3165  }
3166 
3167  switch (unit) {
3168  case TIMELEN_HOURS:
3169  amount *= 60;
3170  /* fall-through */
3171  case TIMELEN_MINUTES:
3172  amount *= 60;
3173  /* fall-through */
3174  case TIMELEN_SECONDS:
3175  amount *= 1000;
3176  /* fall-through */
3177  case TIMELEN_MILLISECONDS:
3178  ;
3179  }
3180  *result = amount > INT_MAX ? INT_MAX : (int) amount;
3181  return 0;
3182 }
#define FMT
static PGresult * result
Definition: cel_pgsql.c:88

◆ ast_app_run_macro()

int ast_app_run_macro ( struct ast_channel autoservice_chan,
struct ast_channel macro_chan,
const char *  macro_name,
const char *  macro_args 
)

Run a macro on a channel, placing an optional second channel into autoservice.

Since
1.8

This is a shorthand method that makes it very easy to run a macro on any given channel. It is perfectly reasonable to supply a NULL autoservice_chan here in case there is no channel to place into autoservice.

Note
Absolutely NO channel locks should be held before calling this function.
Parameters
autoservice_chanA channel to place into autoservice while the macro is run
macro_chanChannel to execute macro on.
macro_nameThe name of the macro to run.
macro_argsThe arguments to pass to the macro.
Return values
0success
-1on error
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 320 of file main/app.c.

References ast_app_exec_macro(), ast_free, ast_malloc, and ast_strlen_zero.

Referenced by ast_channel_connected_line_macro(), and ast_channel_redirecting_macro().

321 {
322  int res;
323  char *args_str;
324  size_t args_len;
325 
326  if (ast_strlen_zero(macro_args)) {
327  return ast_app_exec_macro(autoservice_chan, macro_chan, macro_name);
328  }
329 
330  /* Create the Macro application argument string. */
331  args_len = strlen(macro_name) + strlen(macro_args) + 2;
332  args_str = ast_malloc(args_len);
333  if (!args_str) {
334  return -1;
335  }
336  snprintf(args_str, args_len, "%s,%s", macro_name, macro_args);
337 
338  res = ast_app_exec_macro(autoservice_chan, macro_chan, args_str);
339  ast_free(args_str);
340  return res;
341 }
#define ast_strlen_zero(foo)
Definition: strings.h:52
int ast_app_exec_macro(struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char *macro_args)
Run a macro on a channel, placing an optional second channel into autoservice.
Definition: main/app.c:273
#define ast_malloc(len)
A wrapper for malloc()
Definition: astmm.h:193
#define ast_free(a)
Definition: astmm.h:182

◆ ast_app_run_sub()

int ast_app_run_sub ( struct ast_channel autoservice_chan,
struct ast_channel sub_chan,
const char *  sub_location,
const char *  sub_args,
int  ignore_hangup 
)

Run a subroutine on a channel, placing an optional second channel into autoservice.

Since
11

This is a shorthand method that makes it very easy to run a subroutine on any given channel. It is perfectly reasonable to supply a NULL autoservice_chan here in case there is no channel to place into autoservice.

Note
Absolutely NO channel locks should be held before calling this function.
Parameters
autoservice_chanA channel to place into autoservice while the subroutine is run
sub_chanChannel to execute subroutine on.
sub_locationThe location of the subroutine to run.
sub_argsThe arguments to pass to the subroutine.
ignore_hangupTRUE if a hangup does not stop execution of the routine.
Return values
0success
-1on error
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 401 of file main/app.c.

References AO2_GLOBAL_OBJ_STATIC(), ast_app_exec_sub(), ast_free, ast_malloc, and ast_strlen_zero.

Referenced by ast_channel_connected_line_sub(), and ast_channel_redirecting_sub().

402 {
403  int res;
404  char *args_str;
405  size_t args_len;
406 
407  if (ast_strlen_zero(sub_args)) {
408  return ast_app_exec_sub(autoservice_chan, sub_chan, sub_location, ignore_hangup);
409  }
410 
411  /* Create the Gosub application argument string. */
412  args_len = strlen(sub_location) + strlen(sub_args) + 3;
413  args_str = ast_malloc(args_len);
414  if (!args_str) {
415  return -1;
416  }
417  snprintf(args_str, args_len, "%s(%s)", sub_location, sub_args);
418 
419  res = ast_app_exec_sub(autoservice_chan, sub_chan, args_str, ignore_hangup);
420  ast_free(args_str);
421  return res;
422 }
#define ast_strlen_zero(foo)
Definition: strings.h:52
#define ast_malloc(len)
A wrapper for malloc()
Definition: astmm.h:193
#define ast_free(a)
Definition: astmm.h:182
int ast_app_exec_sub(struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_args, int ignore_hangup)
Run a subroutine on a channel, placing an optional second channel into autoservice.
Definition: main/app.c:370

◆ ast_app_sayname()

int ast_app_sayname ( struct ast_channel chan,
const char *  mailbox_id 
)

Play a recorded user name for the mailbox to the specified channel.

Parameters
chanWhere to play the recorded name file.
mailbox_idThe mailbox name.
Return values
0Name played without interruption
dtmfASCII value of the DTMF which interrupted playback.
-1Unable to locate mailbox or hangup occurred.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 710 of file main/app.c.

References sayname(), and VM_GREETER_API_CALL.

Referenced by play_mailbox_owner(), and spy_sayname().

711 {
712  int res = -1;
713 
714  VM_GREETER_API_CALL(res, sayname, (chan, mailbox_id));
715  return res;
716 }
static int sayname(struct ast_channel *chan, const char *mailbox, const char *context)
#define VM_GREETER_API_CALL(res, api_call, api_parms)
Definition: main/app.c:641

◆ ast_close_fds_above_n()

void ast_close_fds_above_n ( int  n)

Common routine for child processes, to close all fds prior to exec(2)

Parameters
[in]nstarting file descriptor number for closing all higher file descriptors
Since
1.6.1
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3042 of file main/app.c.

References closefrom().

Referenced by app_exec(), asterisk_daemon(), icesencode(), launch_script(), mp3play(), NBScatplay(), safe_exec_prep(), send_waveform_to_fd(), spawn_mp3(), spawn_ras(), and vm_check_password_shell().

3043 {
3044  closefrom(n + 1);
3045 }
void closefrom(int lowfd)
Definition: strcompat.c:429

◆ ast_control_streamfile()

int ast_control_streamfile ( struct ast_channel chan,
const char *  file,
const char *  fwd,
const char *  rev,
const char *  stop,
const char *  pause,
const char *  restart,
int  skipms,
long *  offsetms 
)

Stream a file with fast forward, pause, reverse, restart.

Parameters
chanChannel
fileFile to play.
fwd,rev,stop,pause,restartDTMF keys for media control
skipmsNumber of milliseconds to skip for fwd/rev.
offsetmsNumber of milliseconds to skip when starting the media.

Before calling this function, set this to be the number of ms to start from the beginning of the file. When the function returns, it will be the number of ms from the beginning where the playback stopped. Pass NULL if you don't care.

Return values
0on success
Non-zeroon failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1319 of file main/app.c.

References control_streamfile(), and NULL.

Referenced by controlplayback_exec(), handle_controlstreamfile(), and wait_file().

1323 {
1324  return control_streamfile(chan, file, fwd, rev, stop, suspend, restart, skipms, offsetms, NULL, NULL);
1325 }
unsigned int stop
Definition: app_meetme.c:1096
#define NULL
Definition: resample.c:96
static int skipms
static void suspend(struct cc_core_instance *core_instance)
Definition: ccss.c:3193
static int control_streamfile(struct ast_channel *chan, const char *file, const char *fwd, const char *rev, const char *stop, const char *suspend, const char *restart, int skipms, long *offsetms, const char *lang, ast_waitstream_fr_cb cb)
Definition: main/app.c:1131

◆ ast_control_streamfile_lang()

int ast_control_streamfile_lang ( struct ast_channel chan,
const char *  file,
const char *  fwd,
const char *  rev,
const char *  stop,
const char *  suspend,
const char *  restart,
int  skipms,
const char *  lang,
long *  offsetms 
)

Version of ast_control_streamfile() which allows the language of the media file to be specified.

Return values
0on success
Non-zeroon failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1327 of file main/app.c.

References control_streamfile(), and NULL.

Referenced by play_on_channel().

1330 {
1331  return control_streamfile(chan, file, fwd, rev, stop, suspend, restart, skipms, offsetms, lang, NULL);
1332 }
unsigned int stop
Definition: app_meetme.c:1096
#define NULL
Definition: resample.c:96
static int skipms
static void suspend(struct cc_core_instance *core_instance)
Definition: ccss.c:3193
static int control_streamfile(struct ast_channel *chan, const char *file, const char *fwd, const char *rev, const char *stop, const char *suspend, const char *restart, int skipms, long *offsetms, const char *lang, ast_waitstream_fr_cb cb)
Definition: main/app.c:1131

◆ ast_control_streamfile_w_cb()

int ast_control_streamfile_w_cb ( struct ast_channel chan,
const char *  file,
const char *  fwd,
const char *  rev,
const char *  stop,
const char *  pause,
const char *  restart,
int  skipms,
long *  offsetms,
ast_waitstream_fr_cb  cb 
)

Stream a file with fast forward, pause, reverse, restart.

Parameters
chan
filefilename
fwd,rev,stop,pause,restart,skipms,offsetms
cbwaitstream callback to invoke when fastforward or rewind occurrs.

Before calling this function, set this to be the number of ms to start from the beginning of the file. When the function returns, it will be the number of ms from the beginning where the playback stopped. Pass NULL if you don't care.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1305 of file main/app.c.

References control_streamfile(), and NULL.

1315 {
1316  return control_streamfile(chan, file, fwd, rev, stop, suspend, restart, skipms, offsetms, NULL, cb);
1317 }
unsigned int stop
Definition: app_meetme.c:1096
#define NULL
Definition: resample.c:96
static int skipms
static void suspend(struct cc_core_instance *core_instance)
Definition: ccss.c:3193
static int control_streamfile(struct ast_channel *chan, const char *file, const char *fwd, const char *rev, const char *stop, const char *suspend, const char *restart, int skipms, long *offsetms, const char *lang, ast_waitstream_fr_cb cb)
Definition: main/app.c:1131

◆ ast_control_tone()

int ast_control_tone ( struct ast_channel chan,
const char *  tone 
)

Controls playback of a tone.

Return values
0on success
Non-zeroon failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1399 of file main/app.c.

References ast_channel_zone(), AST_FRAME_CONTROL, ast_get_indication_tone(), ast_get_indication_zone(), ast_playtones_start(), ast_read_noaudio(), ast_strdupa, ast_strlen_zero, ast_tone_zone_sound_unref(), ast_tone_zone_unref(), ast_waitfor(), control_tone_frame_response(), CONTROL_TONE_RESPONSE_FAILED, CONTROL_TONE_RESPONSE_FINISHED, ast_tone_zone_sound::data, ast_frame::frametype, NULL, and parse_tone_uri().

Referenced by play_on_channel().

1400 {
1401  struct ast_tone_zone *zone = NULL;
1402  struct ast_tone_zone_sound *ts;
1403  int paused = 0;
1404  int res = 0;
1405 
1406  const char *tone_indication = NULL;
1407  const char *tone_zone = NULL;
1408  char *tone_uri_parser;
1409 
1410  if (ast_strlen_zero(tone)) {
1411  return -1;
1412  }
1413 
1414  tone_uri_parser = ast_strdupa(tone);
1415 
1416  if (parse_tone_uri(tone_uri_parser, &tone_indication, &tone_zone)) {
1417  return -1;
1418  }
1419 
1420  if (tone_zone) {
1421  zone = ast_get_indication_zone(tone_zone);
1422  }
1423 
1424  ts = ast_get_indication_tone(zone ? zone : ast_channel_zone(chan), tone_indication);
1425 
1426  if (ast_playtones_start(chan, 0, ts ? ts->data : tone_indication, 0)) {
1427  res = -1;
1428  }
1429 
1430  while (!res) {
1431  struct ast_frame *fr;
1432 
1433  if (ast_waitfor(chan, -1) < 0) {
1434  res = -1;
1435  break;
1436  }
1437 
1438  fr = ast_read_noaudio(chan);
1439 
1440  if (!fr) {
1441  res = -1;
1442  break;
1443  }
1444 
1445  if (fr->frametype != AST_FRAME_CONTROL) {
1446  continue;
1447  }
1448 
1449  res = control_tone_frame_response(chan, fr, ts, tone_indication, &paused);
1450  if (res == CONTROL_TONE_RESPONSE_FINISHED) {
1451  res = 0;
1452  break;
1453  } else if (res == CONTROL_TONE_RESPONSE_FAILED) {
1454  res = -1;
1455  break;
1456  }
1457  }
1458 
1459  if (ts) {
1461  }
1462 
1463  if (zone) {
1464  ast_tone_zone_unref(zone);
1465  }
1466 
1467  return res;
1468 }
static struct ast_tone_zone * ast_tone_zone_unref(struct ast_tone_zone *tz)
Release a reference to an ast_tone_zone.
Definition: indications.h:205
static int parse_tone_uri(char *tone_parser, const char **tone_indication, const char **tone_zone)
Definition: main/app.c:1378
struct ast_tone_zone * ast_channel_zone(const struct ast_channel *chan)
#define NULL
Definition: resample.c:96
#define ast_strlen_zero(foo)
Definition: strings.h:52
A set of tones for a given locale.
Definition: indications.h:74
#define ast_strdupa(s)
duplicate a string in memory from the stack
Definition: astmm.h:300
static struct ast_tone_zone_sound * ast_tone_zone_sound_unref(struct ast_tone_zone_sound *ts)
Release a reference to an ast_tone_zone_sound.
Definition: indications.h:227
struct ast_tone_zone * ast_get_indication_zone(const char *country)
locate ast_tone_zone
Definition: indications.c:433
Description of a tone.
Definition: indications.h:35
struct ast_tone_zone_sound * ast_get_indication_tone(const struct ast_tone_zone *zone, const char *indication)
Locate a tone zone sound.
Definition: indications.c:455
static enum control_tone_frame_response_result control_tone_frame_response(struct ast_channel *chan, struct ast_frame *fr, struct ast_tone_zone_sound *ts, const char *tone, int *paused)
Definition: main/app.c:1340
int ast_waitfor(struct ast_channel *chan, int ms)
Wait for input on a channel.
Definition: channel.c:3171
Data structure associated with a single frame of data.
int ast_playtones_start(struct ast_channel *chan, int vol, const char *tonelist, int interruptible)
Start playing a list of tones on a channel.
Definition: indications.c:302
const char * data
Description of a tone.
Definition: indications.h:52
enum ast_frame_type frametype
struct ast_frame * ast_read_noaudio(struct ast_channel *chan)
Reads a frame, returning AST_FRAME_NULL frame if audio.
Definition: channel.c:4312

◆ ast_dtmf_stream()

int ast_dtmf_stream ( struct ast_channel chan,
struct ast_channel peer,
const char *  digits,
int  between,
unsigned int  duration 
)

Send a string of DTMF digits to a channel.

Parameters
chanThe channel that will receive the DTMF frames
peer(optional) Peer channel that will be autoserviced while the primary channel is receiving DTMF
digitsThis is a string of characters representing the DTMF digits to be sent to the channel. Valid characters are "0123456789*#abcdABCD". Note: You can pass arguments 'f' or 'F', if you want to Flash the channel (if supported by the channel), or 'w' to add a 500 millisecond pause to the DTMF sequence.
betweenThis is the number of milliseconds to wait in between each DTMF digit. If zero milliseconds is specified, then the default value of 100 will be used.
durationThis is the duration that each DTMF digit should have.
Precondition
This must only be called by the channel's media handler thread.
Return values
0on success.
-1on failure or a channel hung up.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 981 of file main/app.c.

References ast_autoservice_start(), ast_autoservice_stop(), and dtmf_stream().

Referenced by ast_eivr_senddtmf(), bridge_channel_dtmf_stream(), dial_exec_full(), dtmf_no_bridge(), handle_cli_misdn_send_digit(), senddtmf_exec(), testclient_exec(), testserver_exec(), and wait_for_answer().

982 {
983  int res;
984 
985  if (peer && ast_autoservice_start(peer)) {
986  return -1;
987  }
988  res = dtmf_stream(chan, digits, between, duration, 0);
989  if (peer && ast_autoservice_stop(peer)) {
990  res = -1;
991  }
992 
993  return res;
994 }
int ast_autoservice_start(struct ast_channel *chan)
Automatically service a channel for us...
Definition: autoservice.c:200
static int dtmf_stream(struct ast_channel *chan, const char *digits, int between, unsigned int duration, int is_external)
Definition: main/app.c:899
int ast_autoservice_stop(struct ast_channel *chan)
Stop servicing a channel for us...
Definition: autoservice.c:266

◆ ast_dtmf_stream_external()

void ast_dtmf_stream_external ( struct ast_channel chan,
const char *  digits,
int  between,
unsigned int  duration 
)

Send a string of DTMF digits to a channel from an external thread.

Parameters
chanThe channel that will receive the DTMF frames
digitsThis is a string of characters representing the DTMF digits to be sent to the channel. Valid characters are "0123456789*#abcdABCD". Note: You can pass arguments 'f' or 'F', if you want to Flash the channel (if supported by the channel), or 'w' to add a 500 millisecond pause to the DTMF sequence.
betweenThis is the number of milliseconds to wait in between each DTMF digit. If zero milliseconds is specified, then the default value of 100 will be used.
durationThis is the duration that each DTMF digit should have.
Precondition
This must only be called by threads that are not the channel's media handler thread.
Returns
Nothing
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 996 of file main/app.c.

References dtmf_stream().

Referenced by dtmf_in_bridge().

997 {
998  dtmf_stream(chan, digits, between, duration, 1);
999 }
static int dtmf_stream(struct ast_channel *chan, const char *digits, int between, unsigned int duration, int is_external)
Definition: main/app.c:899

◆ ast_get_encoded_char()

int ast_get_encoded_char ( const char *  stream,
char *  result,
size_t *  consumed 
)

Decode an encoded control or extended ASCII character.

Parameters
[in]streamString to decode
[out]resultDecoded character
[out]consumedNumber of characters used in stream to encode the character
Return values
-1Stream is of zero length
0Success
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2927 of file main/app.c.

References ast_debug, ast_log, ast_strlen_zero, and LOG_ERROR.

Referenced by ast_get_encoded_str(), ast_str_get_encoded_str(), cut_internal(), filter(), function_fieldnum_helper(), function_fieldqty_helper(), replace(), shift_pop(), and unshift_push().

2928 {
2929  int i;
2930  *consumed = 1;
2931  *result = 0;
2932  if (ast_strlen_zero(stream)) {
2933  *consumed = 0;
2934  return -1;
2935  }
2936 
2937  if (*stream == '\\') {
2938  *consumed = 2;
2939  switch (*(stream + 1)) {
2940  case 'n':
2941  *result = '\n';
2942  break;
2943  case 'r':
2944  *result = '\r';
2945  break;
2946  case 't':
2947  *result = '\t';
2948  break;
2949  case 'x':
2950  /* Hexadecimal */
2951  if (strchr("0123456789ABCDEFabcdef", *(stream + 2)) && *(stream + 2) != '\0') {
2952  *consumed = 3;
2953  if (*(stream + 2) <= '9') {
2954  *result = *(stream + 2) - '0';
2955  } else if (*(stream + 2) <= 'F') {
2956  *result = *(stream + 2) - 'A' + 10;
2957  } else {
2958  *result = *(stream + 2) - 'a' + 10;
2959  }
2960  } else {
2961  ast_log(LOG_ERROR, "Illegal character '%c' in hexadecimal string\n", *(stream + 2));
2962  return -1;
2963  }
2964 
2965  if (strchr("0123456789ABCDEFabcdef", *(stream + 3)) && *(stream + 3) != '\0') {
2966  *consumed = 4;
2967  *result <<= 4;
2968  if (*(stream + 3) <= '9') {
2969  *result += *(stream + 3) - '0';
2970  } else if (*(stream + 3) <= 'F') {
2971  *result += *(stream + 3) - 'A' + 10;
2972  } else {
2973  *result += *(stream + 3) - 'a' + 10;
2974  }
2975  }
2976  break;
2977  case '0':
2978  /* Octal */
2979  *consumed = 2;
2980  for (i = 2; ; i++) {
2981  if (strchr("01234567", *(stream + i)) && *(stream + i) != '\0') {
2982  (*consumed)++;
2983  ast_debug(5, "result was %d, ", *result);
2984  *result <<= 3;
2985  *result += *(stream + i) - '0';
2986  ast_debug(5, "is now %d\n", *result);
2987  } else {
2988  break;
2989  }
2990  }
2991  break;
2992  default:
2993  *result = *(stream + 1);
2994  }
2995  } else {
2996  *result = *stream;
2997  *consumed = 1;
2998  }
2999  return 0;
3000 }
#define ast_strlen_zero(foo)
Definition: strings.h:52
#define ast_debug(level,...)
Log a DEBUG message.
Definition: logger.h:452
#define ast_log
Definition: astobj2.c:42
#define LOG_ERROR
Definition: logger.h:285
static PGresult * result
Definition: cel_pgsql.c:88

◆ ast_get_encoded_str()

char* ast_get_encoded_str ( const char *  stream,
char *  result,
size_t  result_len 
)

Decode a stream of encoded control or extended ASCII characters.

Parameters
[in]streamEncoded string
[out]resultDecoded string
[in]result_lenMaximum size of the result buffer
Returns
A pointer to the result string
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3002 of file main/app.c.

References ast_get_encoded_char(), and result.

Referenced by chan_pjsip_new(), listfilter(), mgcp_new(), replace(), sip_addheader(), and sip_new().

3003 {
3004  char *cur = result;
3005  size_t consumed;
3006 
3007  while (cur < result + result_size - 1 && !ast_get_encoded_char(stream, cur, &consumed)) {
3008  cur++;
3009  stream += consumed;
3010  }
3011  *cur = '\0';
3012  return result;
3013 }
static PGresult * result
Definition: cel_pgsql.c:88
int ast_get_encoded_char(const char *stream, char *result, size_t *consumed)
Decode an encoded control or extended ASCII character.
Definition: main/app.c:2927

◆ ast_install_stack_functions()

void ast_install_stack_functions ( const struct ast_app_stack_funcs funcs)

Set stack application function callbacks.

Since
11
Parameters
funcsStack applications callback functions.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 346 of file main/app.c.

Referenced by load_module(), and unload_module().

347 {
348  app_stack_callbacks = funcs;
349 }
static const struct ast_app_stack_funcs * app_stack_callbacks
Definition: main/app.c:344

◆ ast_install_vm_test_functions()

void ast_install_vm_test_functions ( ast_vm_test_create_user_fn vm_test_create_user_func,
ast_vm_test_destroy_user_fn vm_test_destroy_user_func 
)
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 599 of file main/app.c.

References ast_vm_test_create_user_func, and ast_vm_test_destroy_user_func.

Referenced by load_module().

601 {
602  ast_vm_test_create_user_func = vm_test_create_user_func;
603  ast_vm_test_destroy_user_func = vm_test_destroy_user_func;
604 }
static ast_vm_test_create_user_fn * ast_vm_test_create_user_func
Definition: main/app.c:596
static ast_vm_test_destroy_user_fn * ast_vm_test_destroy_user_func
Definition: main/app.c:597

◆ ast_ivr_menu_run()

int ast_ivr_menu_run ( struct ast_channel c,
struct ast_ivr_menu menu,
void *  cbdata 
)

Runs an IVR menu.

Returns
returns 0 on successful completion, -1 on hangup, or -2 on user error in menu
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2785 of file main/app.c.

References ast_ivr_menu_run_internal().

Referenced by skel_exec().

2786 {
2787  int res = ast_ivr_menu_run_internal(chan, menu, cbdata);
2788  /* Hide internal coding */
2789  return res > 0 ? 0 : res;
2790 }
static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
Definition: main/app.c:2700

◆ ast_linear_stream()

int ast_linear_stream ( struct ast_channel chan,
const char *  filename,
int  fd,
int  allowoverride 
)

Stream a filename (or file descriptor) as a generator.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1089 of file main/app.c.

References linear_state::allowoverride, ast_activate_generator(), ast_calloc, ast_config_AST_DATA_DIR, ast_copy_string(), ast_log, ast_strlen_zero, linear_state::autoclose, errno, linear_state::fd, and LOG_WARNING.

1090 {
1091  struct linear_state *lin;
1092  char tmpf[256];
1093  int autoclose = 0;
1094 
1095  if (fd < 0) {
1096  if (ast_strlen_zero(filename)) {
1097  return -1;
1098  }
1099 
1100  autoclose = 1;
1101 
1102  if (filename[0] == '/') {
1103  ast_copy_string(tmpf, filename, sizeof(tmpf));
1104  } else {
1105  snprintf(tmpf, sizeof(tmpf), "%s/%s/%s", ast_config_AST_DATA_DIR, "sounds", filename);
1106  }
1107 
1108  fd = open(tmpf, O_RDONLY);
1109  if (fd < 0) {
1110  ast_log(LOG_WARNING, "Unable to open file '%s': %s\n", tmpf, strerror(errno));
1111  return -1;
1112  }
1113  }
1114 
1115  lin = ast_calloc(1, sizeof(*lin));
1116  if (!lin) {
1117  if (autoclose) {
1118  close(fd);
1119  }
1120 
1121  return -1;
1122  }
1123 
1124  lin->fd = fd;
1126  lin->autoclose = autoclose;
1127 
1128  return ast_activate_generator(chan, &linearstream, lin);
1129 }
int ast_activate_generator(struct ast_channel *chan, struct ast_generator *gen, void *params)
Definition: channel.c:2960
#define LOG_WARNING
Definition: logger.h:274
#define ast_strlen_zero(foo)
Definition: strings.h:52
#define ast_log
Definition: astobj2.c:42
const char * ast_config_AST_DATA_DIR
Definition: options.c:158
int errno
static struct ast_generator linearstream
Definition: main/app.c:1082
#define ast_calloc(num, len)
A wrapper for calloc()
Definition: astmm.h:204
int allowoverride
Definition: main/app.c:1004
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401

◆ ast_lock_path()

enum AST_LOCK_RESULT ast_lock_path ( const char *  path)

Lock a filesystem path.

Parameters
paththe path to be locked
Returns
one of AST_LOCK_RESULT values
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2457 of file main/app.c.

References AST_LOCK_FAILURE, ast_lock_path_flock(), ast_lock_path_lockfile(), AST_LOCK_TYPE_FLOCK, and AST_LOCK_TYPE_LOCKFILE.

Referenced by ast_module_reload(), test_vm_api_create_voicemail_files(), and vm_lock_path().

2458 {
2460 
2461  switch (ast_lock_type) {
2463  r = ast_lock_path_lockfile(path);
2464  break;
2465  case AST_LOCK_TYPE_FLOCK:
2466  r = ast_lock_path_flock(path);
2467  break;
2468  }
2469 
2470  return r;
2471 }
static enum AST_LOCK_RESULT ast_lock_path_lockfile(const char *path)
Definition: main/app.c:2263
ast_lock_type
Definition: lock.h:252
static enum AST_LOCK_RESULT ast_lock_path_flock(const char *path)
Definition: main/app.c:2337

◆ ast_mf_stream()

int ast_mf_stream ( struct ast_channel chan,
struct ast_channel peer,
const char *  digits,
int  between,
unsigned int  duration,
unsigned int  durationkp,
unsigned int  durationst,
int  is_external 
)

Send a string of MF digits to a channel.

Parameters
chanThe channel that will receive the MF frames
peer(optional) Peer channel that will be autoserviced while the primary channel is receiving MF
digitsThis is a string of characters representing the MF digits to be sent to the channel. Valid characters are "0123456789*#abcdABCD". Note: You can pass arguments 'f' or 'F', if you want to Flash the channel (if supported by the channel), or 'w' or 'W' to add a wink (if supported by the channel).
betweenThis is the number of milliseconds to wait in between each MF digit. If zero milliseconds is specified, then the default value of 50 will be used.
durationThis is the duration that each numeric MF digit should have. Default value is 55.
durationkpThis is the duration that each KP digit should have. Default is 120.
durationstThis is the duration that each ST, STP, ST2P, or ST3P digit should have. Default is 65.
is_external1 if called by a thread that is not the channel's media handler thread, 0 if called by the channel's media handler thread.
Return values
0on success.
-1on failure or a channel hung up.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 967 of file main/app.c.

References ast_autoservice_start(), ast_autoservice_stop(), and mf_stream().

Referenced by dial_exec_full(), manager_play_mf(), sendmf_exec(), and wait_for_answer().

969 {
970  int res;
971  if (!is_external && peer && ast_autoservice_start(peer)) {
972  return -1;
973  }
974  res = mf_stream(chan, digits, between, duration, durationkp, durationst, is_external);
975  if (!is_external && peer && ast_autoservice_stop(peer)) {
976  res = -1;
977  }
978  return res;
979 }
int ast_autoservice_start(struct ast_channel *chan)
Automatically service a channel for us...
Definition: autoservice.c:200
static int mf_stream(struct ast_channel *chan, const char *digits, int between, unsigned int duration, unsigned int durationkp, unsigned int durationst, int is_external)
Definition: main/app.c:836
int ast_autoservice_stop(struct ast_channel *chan)
Stop servicing a channel for us...
Definition: autoservice.c:266

◆ ast_play_and_prepend()

int ast_play_and_prepend ( struct ast_channel chan,
char *  playfile,
char *  recordfile,
int  maxtime_sec,
char *  fmt,
int *  duration,
int *  sound_duration,
int  beep,
int  silencethreshold,
int  maxsilence_ms 
)

Record a file based on input frm a channel. Recording is performed in 'prepend' mode which works a little differently from normal recordings This function will not play a success message due to post-recording control in the application this was added for.

Parameters
chanthe channel being recorded
playfileFilename of sound to play before recording begins
recordfileFilename to save the recording
maxtime_secLongest possible message length in seconds
fmtstring containing all formats to be recorded delimited by '|'
durationpointer to integer for storing length of the recording
sound_durationpointer to integer for storing length of the recording minus all silence
beepwhether to play a beep to prompt the recording
silencethresholdtolerance of noise levels that can be considered silence for the purpose of silence timeout, -1 for default
maxsilence_mslength of time in milliseconds which will trigger a timeout from silence, -1 for default.
Return values
-1failure or hangup
'S'Recording ended from silence timeout
't'Recording either exceeded maximum duration or the call was ended via DTMF
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2002 of file main/app.c.

References __ast_play_and_record(), AST_RECORD_IF_EXISTS_OVERWRITE, default_acceptdtmf, default_canceldtmf, and NULL.

Referenced by vm_forwardoptions().

2003 {
2004  return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, sound_duration, beep, silencethreshold, maxsilence, NULL, 1, default_acceptdtmf, default_canceldtmf, 1, AST_RECORD_IF_EXISTS_OVERWRITE);
2005 }
static int __ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence, const char *path, int prepend, const char *acceptdtmf, const char *canceldtmf, int skip_confirmation_sound, enum ast_record_if_exists if_exists)
Definition: main/app.c:1580
static const char default_acceptdtmf[]
Definition: main/app.c:1989
static const char default_canceldtmf[]
Definition: main/app.c:1990
static int maxsilence
#define NULL
Definition: resample.c:96
static int silencethreshold

◆ ast_play_and_record()

int ast_play_and_record ( struct ast_channel chan,
const char *  playfile,
const char *  recordfile,
int  maxtime_sec,
const char *  fmt,
int *  duration,
int *  sound_duration,
int  silencethreshold,
int  maxsilence_ms,
const char *  path 
)

Record a file based on input from a channel. Use default accept and cancel DTMF. This function will play "auth-thankyou" upon successful recording.

Parameters
chanthe channel being recorded
playfileFilename of sound to play before recording begins
recordfileFilename to save the recording
maxtime_secLongest possible message length in seconds
fmtstring containing all formats to be recorded delimited by '|'
durationpointer to integer for storing length of the recording
sound_durationpointer to integer for storing length of the recording minus all silence
silencethresholdtolerance of noise levels that can be considered silence for the purpose of silence timeout, -1 for default
maxsilence_mslength of time in milliseconds which will trigger a timeout from silence, -1 for default
pathOptional filesystem path to unlock
Return values
-1failure or hangup
'S'Recording ended from silence timeout
't'Recording ended from the message exceeding the maximum duration
dtmfcharRecording ended via the return value's DTMF character for either cancel or accept.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1997 of file main/app.c.

References __ast_play_and_record(), AST_RECORD_IF_EXISTS_OVERWRITE, default_acceptdtmf, and default_canceldtmf.

Referenced by app_exec(), ast_record_review(), conf_rec_name(), conf_run(), and setup_privacy_args().

1998 {
1999  return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, sound_duration, 0, silencethreshold, maxsilence, path, 0, default_acceptdtmf, default_canceldtmf, 0, AST_RECORD_IF_EXISTS_OVERWRITE);
2000 }
static int __ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence, const char *path, int prepend, const char *acceptdtmf, const char *canceldtmf, int skip_confirmation_sound, enum ast_record_if_exists if_exists)
Definition: main/app.c:1580
static const char default_acceptdtmf[]
Definition: main/app.c:1989
static const char default_canceldtmf[]
Definition: main/app.c:1990
static int maxsilence
static int silencethreshold

◆ ast_play_and_record_full()

int ast_play_and_record_full ( struct ast_channel chan,
const char *  playfile,
const char *  recordfile,
int  maxtime_sec,
const char *  fmt,
int *  duration,
int *  sound_duration,
int  beep,
int  silencethreshold,
int  maxsilence_ms,
const char *  path,
const char *  acceptdtmf,
const char *  canceldtmf,
int  skip_confirmation_sound,
enum ast_record_if_exists  if_exists 
)

Record a file based on input from a channel This function will play "auth-thankyou" upon successful recording if skip_confirmation_sound is false.

Parameters
chanthe channel being recorded
playfileFilename of sound to play before recording begins. A beep is also played when playfile completes, before the recording begins.
recordfileFilename to save the recording
maxtime_secLongest possible message length in seconds
fmtstring containing all formats to be recorded delimited by '|'
durationpointer to integer for storing length of the recording
beepIf true, play a beep before recording begins (and doesn't play playfile)
sound_durationpointer to integer for storing length of the recording minus all silence
silencethresholdtolerance of noise levels that can be considered silence for the purpose of silence timeout, -1 for default
maxsilence_msLength of time in milliseconds which will trigger a timeout from silence, -1 for default
pathOptional filesystem path to unlock
acceptdtmfCharacter of DTMF to end and accept the recording
canceldtmfCharacter of DTMF to end and cancel the recording
skip_confirmation_soundIf true, don't play auth-thankyou at end. Nice for custom recording prompts in apps.
if_existsAction to take if recording already exists.
Return values
-1failure or hangup
'S'Recording ended from silence timeout
't'Recording ended from the message exceeding the maximum duration
dtmfcharRecording ended via the return value's DTMF character for either cancel or accept.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1992 of file main/app.c.

References __ast_play_and_record(), default_canceldtmf, and S_OR.

Referenced by play_record_review(), and record_file().

1993 {
1994  return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, sound_duration, beep, silencethreshold, maxsilence, path, 0, S_OR(acceptdtmf, ""), S_OR(canceldtmf, default_canceldtmf), skip_confirmation_sound, if_exists);
1995 }
static int __ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence, const char *path, int prepend, const char *acceptdtmf, const char *canceldtmf, int skip_confirmation_sound, enum ast_record_if_exists if_exists)
Definition: main/app.c:1580
static const char default_canceldtmf[]
Definition: main/app.c:1990
static int maxsilence
static int silencethreshold
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79

◆ ast_play_and_wait()

int ast_play_and_wait ( struct ast_channel chan,
const char *  fn 
)

Play a stream and wait for a digit, returning the digit that was pressed.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 1470 of file main/app.c.

References ast_channel_language(), AST_DIGIT_ANY, ast_stopstream(), ast_streamfile(), ast_waitstream(), and d.

Referenced by __ast_play_and_record(), advanced_options(), ast_record_review(), ast_say_counted_adjective(), ast_say_counted_noun(), dialout(), forward_message(), get_folder(), get_folder2(), get_folder_ja(), leave_voicemail(), minivm_greet_exec(), play_message_category(), play_message_duration(), play_record_review(), valid_priv_reply(), vm_allocate_dh(), vm_authenticate(), vm_browse_messages_en(), vm_browse_messages_es(), vm_browse_messages_gr(), vm_browse_messages_he(), vm_browse_messages_it(), vm_browse_messages_ja(), vm_browse_messages_pt(), vm_browse_messages_vi(), vm_browse_messages_zh(), vm_exec(), vm_execmain(), vm_forwardoptions(), vm_instructions_en(), vm_instructions_ja(), vm_instructions_zh(), vm_intro(), vm_intro_cs(), vm_intro_de(), vm_intro_en(), vm_intro_es(), vm_intro_fr(), vm_intro_gr(), vm_intro_he(), vm_intro_is(), vm_intro_it(), vm_intro_ja(), vm_intro_multilang(), vm_intro_nl(), vm_intro_no(), vm_intro_pl(), vm_intro_pt(), vm_intro_pt_BR(), vm_intro_se(), vm_intro_vi(), vm_intro_zh(), vm_newuser_setup(), vm_options(), vm_play_folder_name(), vm_play_folder_name_gr(), vm_play_folder_name_ja(), vm_play_folder_name_pl(), vm_play_folder_name_ua(), vm_tempgreeting(), and vmauthenticate().

1471 {
1472  int d = 0;
1473 
1474  if ((d = ast_streamfile(chan, fn, ast_channel_language(chan)))) {
1475  return d;
1476  }
1477 
1478  d = ast_waitstream(chan, AST_DIGIT_ANY);
1479 
1480  ast_stopstream(chan);
1481 
1482  return d;
1483 }
int ast_streamfile(struct ast_channel *c, const char *filename, const char *preflang)
Streams a file.
Definition: file.c:1250
#define AST_DIGIT_ANY
Definition: file.h:48
static struct test_val d
int ast_waitstream(struct ast_channel *c, const char *breakon)
Waits for a stream to stop or digit to be pressed.
Definition: file.c:1776
const char * ast_channel_language(const struct ast_channel *chan)
int ast_stopstream(struct ast_channel *c)
Stops a stream.
Definition: file.c:187

◆ ast_queue_topic()

struct stasis_topic* ast_queue_topic ( const char *  queuename)

Get the Stasis Message Bus API topic for queue messages for a particular queue name.

Parameters
queuenameThe name for which to get the topic
Return values
Thetopic structure for queue messages for a given name
NULLif it failed to be found or allocated
Since
12
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3189 of file main/app.c.

References stasis_topic_pool_get_topic().

Referenced by send_agent_complete().

3190 {
3191  return stasis_topic_pool_get_topic(queue_topic_pool, queuename);
3192 }
struct stasis_topic * stasis_topic_pool_get_topic(struct stasis_topic_pool *pool, const char *topic_name)
Find or create a topic in the pool.
Definition: stasis.c:1884
static struct stasis_topic_pool * queue_topic_pool
Definition: main/app.c:91

◆ ast_queue_topic_all()

struct stasis_topic* ast_queue_topic_all ( void  )

Get the Stasis Message Bus API topic for queue messages.

Return values
Thetopic structure for queue messages
NULLif it has not been allocated
Since
12
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3184 of file main/app.c.

References queue_topic_all.

Referenced by load_module().

3185 {
3186  return queue_topic_all;
3187 }
static struct stasis_topic * queue_topic_all
Definition: main/app.c:90

◆ ast_read_textfile()

char* ast_read_textfile ( const char *  file)

Read a file into asterisk.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2792 of file main/app.c.

References ast_free, ast_log, ast_malloc, errno, LOG_WARNING, and NULL.

Referenced by ast_tcptls_server_start().

2793 {
2794  int fd, count = 0, res;
2795  char *output = NULL;
2796  struct stat filesize;
2797 
2798  if (stat(filename, &filesize) == -1) {
2799  ast_log(LOG_WARNING, "Error can't stat %s\n", filename);
2800  return NULL;
2801  }
2802 
2803  count = filesize.st_size + 1;
2804 
2805  if ((fd = open(filename, O_RDONLY)) < 0) {
2806  ast_log(LOG_WARNING, "Cannot open file '%s' for reading: %s\n", filename, strerror(errno));
2807  return NULL;
2808  }
2809 
2810  if ((output = ast_malloc(count))) {
2811  res = read(fd, output, count - 1);
2812  if (res == count - 1) {
2813  output[res] = '\0';
2814  } else {
2815  ast_log(LOG_WARNING, "Short read of %s (%d of %d): %s\n", filename, res, count - 1, strerror(errno));
2816  ast_free(output);
2817  output = NULL;
2818  }
2819  }
2820 
2821  close(fd);
2822 
2823  return output;
2824 }
#define LOG_WARNING
Definition: logger.h:274
#define NULL
Definition: resample.c:96
#define ast_log
Definition: astobj2.c:42
#define ast_malloc(len)
A wrapper for malloc()
Definition: astmm.h:193
int errno
#define ast_free(a)
Definition: astmm.h:182

◆ ast_record_review()

int ast_record_review ( struct ast_channel chan,
const char *  playfile,
const char *  recordfile,
int  maxtime,
const char *  fmt,
int *  duration,
const char *  path 
)

Allow to record message and have a review option.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2489 of file main/app.c.

References AST_DIGIT_ANY, ast_dsp_get_threshold_from_settings(), ast_log, ast_play_and_record(), ast_play_and_wait(), ast_stream_and_wait(), ast_verb, ast_waitfordigit(), LOG_WARNING, maxsilence, NULL, silencethreshold, and THRESHOLD_SILENCE.

Referenced by conf_rec_name(), and conf_run().

2490 {
2491  int silencethreshold;
2492  int maxsilence = 0;
2493  int res = 0;
2494  int cmd = 0;
2495  int max_attempts = 3;
2496  int attempts = 0;
2497  int recorded = 0;
2498  int message_exists = 0;
2499  /* Note that urgent and private are for flagging messages as such in the future */
2500 
2501  /* barf if no pointer passed to store duration in */
2502  if (!duration) {
2503  ast_log(LOG_WARNING, "Error ast_record_review called without duration pointer\n");
2504  return -1;
2505  }
2506 
2507  cmd = '3'; /* Want to start by recording */
2508 
2510 
2511  while ((cmd >= 0) && (cmd != 't')) {
2512  switch (cmd) {
2513  case '1':
2514  if (!message_exists) {
2515  /* In this case, 1 is to record a message */
2516  cmd = '3';
2517  break;
2518  } else {
2519  ast_stream_and_wait(chan, "vm-msgsaved", "");
2520  cmd = 't';
2521  return res;
2522  }
2523  case '2':
2524  /* Review */
2525  ast_verb(3, "Reviewing the recording\n");
2526  cmd = ast_stream_and_wait(chan, recordfile, AST_DIGIT_ANY);
2527  break;
2528  case '3':
2529  message_exists = 0;
2530  /* Record */
2531  ast_verb(3, "R%secording\n", recorded == 1 ? "e-r" : "");
2532  recorded = 1;
2533  if ((cmd = ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, NULL, silencethreshold, maxsilence, path)) == -1) {
2534  /* User has hung up, no options to give */
2535  return cmd;
2536  }
2537  if (cmd == '0') {
2538  break;
2539  } else if (cmd == '*') {
2540  break;
2541  } else {
2542  /* If all is well, a message exists */
2543  message_exists = 1;
2544  cmd = 0;
2545  }
2546  break;
2547  case '4':
2548  case '5':
2549  case '6':
2550  case '7':
2551  case '8':
2552  case '9':
2553  case '*':
2554  case '#':
2555  cmd = ast_play_and_wait(chan, "vm-sorry");
2556  break;
2557  default:
2558  if (message_exists) {
2559  cmd = ast_play_and_wait(chan, "vm-review");
2560  } else {
2561  if (!(cmd = ast_play_and_wait(chan, "vm-torerecord"))) {
2562  cmd = ast_waitfordigit(chan, 600);
2563  }
2564  }
2565 
2566  if (!cmd) {
2567  cmd = ast_waitfordigit(chan, 6000);
2568  }
2569  if (!cmd) {
2570  attempts++;
2571  }
2572  if (attempts > max_attempts) {
2573  cmd = 't';
2574  }
2575  }
2576  }
2577  if (cmd == 't') {
2578  cmd = 0;
2579  }
2580  return cmd;
2581 }
#define AST_DIGIT_ANY
Definition: file.h:48
#define LOG_WARNING
Definition: logger.h:274
static int maxsilence
#define NULL
Definition: resample.c:96
#define ast_verb(level,...)
Definition: logger.h:463
#define ast_log
Definition: astobj2.c:42
static int silencethreshold
int ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int *sound_duration, int silencethreshold, int maxsilence, const char *path)
Record a file based on input from a channel. Use default accept and cancel DTMF. This function will p...
Definition: main/app.c:1997
int ast_stream_and_wait(struct ast_channel *chan, const char *file, const char *digits)
stream file until digit If the file name is non-empty, try to play it.
Definition: file.c:1814
int ast_play_and_wait(struct ast_channel *chan, const char *fn)
Play a stream and wait for a digit, returning the digit that was pressed.
Definition: main/app.c:1470
int ast_waitfordigit(struct ast_channel *c, int ms)
Waits for a digit.
Definition: channel.c:3184
int ast_dsp_get_threshold_from_settings(enum threshold which)
Get silence threshold from dsp.conf.
Definition: dsp.c:1996

◆ ast_replace_sigchld()

void ast_replace_sigchld ( void  )

Replace the SIGCHLD handler.

Normally, Asterisk has a SIGCHLD handler that is cleaning up all zombie processes from forking elsewhere in Asterisk. However, if you want to wait*() on the process to retrieve information about it's exit status, then this signal handler needs to be temporarily replaced.

Code that executes this function must call ast_unreplace_sigchld() after it is finished doing the wait*().

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 801 of file extconf.c.

References ast_mutex_lock, ast_mutex_unlock, ast_unreplace_sigchld(), safe_system_lock, and safe_system_prev_handler.

Referenced by ast_safe_fork(), ast_safe_system(), and safe_exec_prep().

802 {
803  unsigned int level;
804 
805  level = safe_system_level++;
806 
807  /* only replace the handler if it has not already been done */
808  if (level == 0) {
809  sigaction(SIGCHLD, &null_sig_handler, &safe_system_prev_handler);
810  }
811 }
static struct sigaction null_sig_handler
Definition: extconf.c:794
static unsigned int safe_system_level
Keep track of how many threads are currently trying to wait*() on a child process.
Definition: extconf.c:785
static struct sigaction safe_system_prev_handler
Definition: extconf.c:786

◆ ast_safe_execvp()

int ast_safe_execvp ( int  dualfork,
const char *  file,
char *const  argv[] 
)

Safely spawn an external program while closing file descriptors.

Note
This replaces the execvp call in all Asterisk modules
Parameters
dualforkNon-zero to simulate running the program in the background by forking twice. The option provides similar functionality to the '&' in the OS shell command "cmd &". The option allows Asterisk to run a reaper loop to watch the first fork which immediately exits after spaning the second fork. The actual program is run in the second fork.
fileexecvp(file, argv) file parameter
argvexecvp(file, argv) argv parameter

Definition at line 1180 of file asterisk.c.

References safe_exec_prep(), and safe_exec_wait().

Referenced by run_externnotify().

1181 {
1182  pid_t pid = safe_exec_prep(dualfork);
1183 
1184  if (pid == 0) {
1185  execvp(file, argv);
1186  _exit(1);
1187  /* noreturn from _exit */
1188  }
1189 
1190  return safe_exec_wait(pid);
1191 }
static pid_t safe_exec_prep(int dualfork)
fork and perform other preparations for spawning applications
Definition: asterisk.c:1093
static int safe_exec_wait(pid_t pid)
wait for spawned application to complete and unreplace sigchld
Definition: asterisk.c:1154

◆ ast_safe_fork()

int ast_safe_fork ( int  stop_reaper)

Common routine to safely fork without a chance of a signal handler firing badly in the child.

Parameters
[in]stop_reaperflag to determine if sigchld handler is replaced or not
Since
1.6.1
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3047 of file main/app.c.

References ast_calloc, AST_LIST_INSERT_TAIL, AST_LIST_LOCK, AST_LIST_UNLOCK, ast_log, ast_pthread_create_background, AST_PTHREADT_NULL, ast_replace_sigchld(), child_cap, errno, zombie::list, LOG_ERROR, LOG_WARNING, NULL, zombie::pid, shaun_of_the_dead(), and shaun_of_the_dead_thread.

Referenced by app_exec(), filestream_destructor(), icesencode(), launch_script(), mp3play(), NBScatplay(), send_waveform_to_fd(), spawn_mp3(), spawn_ras(), and vm_check_password_shell().

3048 {
3049  sigset_t signal_set, old_set;
3050  int pid;
3051 
3052  /* Don't let the default signal handler for children reap our status */
3053  if (stop_reaper) {
3055  }
3056 
3057  /* GCC 4.9 gives a bogus "right-hand operand of comma expression has
3058  * no effect" warning */
3059  (void) sigfillset(&signal_set);
3060  pthread_sigmask(SIG_BLOCK, &signal_set, &old_set);
3061 
3062  pid = fork();
3063 
3064  if (pid != 0) {
3065  /* Fork failed or parent */
3066  pthread_sigmask(SIG_SETMASK, &old_set, NULL);
3067  if (!stop_reaper && pid > 0) {
3068  struct zombie *cur = ast_calloc(1, sizeof(*cur));
3069  if (cur) {
3070  cur->pid = pid;
3076  ast_log(LOG_ERROR, "Shaun of the Dead wants to kill zombies, but can't?!!\n");
3078  }
3079  }
3080  }
3081  }
3082  return pid;
3083  } else {
3084  /* Child */
3085 #ifdef HAVE_CAP
3086  cap_set_proc(child_cap);
3087 #endif
3088 
3089  /* Before we unblock our signals, return our trapped signals back to the defaults */
3090  signal(SIGHUP, SIG_DFL);
3091  signal(SIGCHLD, SIG_DFL);
3092  signal(SIGINT, SIG_DFL);
3093  signal(SIGURG, SIG_DFL);
3094  signal(SIGTERM, SIG_DFL);
3095  signal(SIGPIPE, SIG_DFL);
3096  signal(SIGXFSZ, SIG_DFL);
3097 
3098  /* unblock important signal handlers */
3099  if (pthread_sigmask(SIG_UNBLOCK, &signal_set, NULL)) {
3100  ast_log(LOG_WARNING, "unable to unblock signals: %s\n", strerror(errno));
3101  _exit(1);
3102  }
3103 
3104  return pid;
3105  }
3106 }
pid_t pid
Definition: main/app.c:78
#define AST_LIST_LOCK(head)
Locks a list.
Definition: linkedlists.h:39
#define LOG_WARNING
Definition: logger.h:274
#define AST_LIST_UNLOCK(head)
Attempts to unlock a list.
Definition: linkedlists.h:139
static pthread_t shaun_of_the_dead_thread
Definition: main/app.c:75
#define NULL
Definition: resample.c:96
#define ast_pthread_create_background(a, b, c, d)
Definition: utils.h:567
#define ast_log
Definition: astobj2.c:42
#define AST_PTHREADT_NULL
Definition: lock.h:66
struct zombie::@333 list
static void * shaun_of_the_dead(void *data)
Definition: main/app.c:94
void ast_replace_sigchld(void)
Replace the SIGCHLD handler.
Definition: extconf.c:801
#define LOG_ERROR
Definition: logger.h:285
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:730
int errno
#define ast_calloc(num, len)
A wrapper for calloc()
Definition: astmm.h:204
static cap_t child_cap
Definition: main/app.c:85

◆ ast_safe_fork_cleanup()

void ast_safe_fork_cleanup ( void  )

Common routine to cleanup after fork'ed process is complete (if reaping was stopped)

Since
1.6.1
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3108 of file main/app.c.

References ast_unreplace_sigchld().

Referenced by agi_exec_full(), and run_ras().

3109 {
3111 }
void ast_unreplace_sigchld(void)
Restore the SIGCHLD handler.
Definition: extconf.c:815

◆ ast_safe_system()

int ast_safe_system ( const char *  s)

Safely spawn an OS shell command while closing file descriptors.

Note
This replaces the system call in all Asterisk modules
Parameters
s- OS shell command string to execute.
Warning
Command injection can happen using this call if the passed in string is created using untrusted data from an external source. It is best not to use untrusted data. However, the caller could filter out dangerous characters to avoid command injection.

Definition at line 829 of file extconf.c.

References ast_log(), ast_replace_sigchld(), ast_unreplace_sigchld(), errno, LOG_WARNING, NULL, safe_exec_prep(), safe_exec_wait(), status, WEXITSTATUS, WIFEXITED, and ast_channel::x.

Referenced by add_email_attachment(), alarmreceiver_exec(), ast_monitor_stop(), AST_TEST_DEFINE(), ast_unreplace_sigchld(), consolehandler(), convert_bdb_to_sqlite3(), mixmonitor_thread(), notify_message(), process_text_line(), remoteconsolehandler(), rotate_file(), run_externnotify(), sendmail(), sendpage(), system_exec_helper(), and vm_change_password_shell().

830 {
831  pid_t pid;
832 #ifdef HAVE_WORKING_FORK
833  int x;
834 #endif
835  int res;
836  int status;
837 
838 #if defined(HAVE_WORKING_FORK) || defined(HAVE_WORKING_VFORK)
840 
841 #ifdef HAVE_WORKING_FORK
842  pid = fork();
843 #else
844  pid = vfork();
845 #endif
846 
847  if (pid == 0) {
848 #ifdef HAVE_WORKING_FORK
849  /* Close file descriptors and launch system command */
850  for (x = STDERR_FILENO + 1; x < 4096; x++)
851  close(x);
852 #endif
853  execl("/bin/sh", "/bin/sh", "-c", s, (char *) NULL);
854  _exit(1);
855  } else if (pid > 0) {
856  for(;;) {
857  res = waitpid(pid, &status, 0);
858  if (res > -1) {
859  res = WIFEXITED(status) ? WEXITSTATUS(status) : -1;
860  break;
861  } else if (errno != EINTR)
862  break;
863  }
864  } else {
865  ast_log(LOG_WARNING, "Fork failed: %s\n", strerror(errno));
866  res = -1;
867  }
868 
870 #else
871  res = -1;
872 #endif
873 
874  return res;
875 }
pid_t pid
Definition: main/app.c:78
void ast_unreplace_sigchld(void)
Restore the SIGCHLD handler.
Definition: extconf.c:815
void ast_replace_sigchld(void)
Replace the SIGCHLD handler.
Definition: extconf.c:801
#define NULL
Definition: resample.c:96
static void ast_log(int level, const char *file, int line, const char *function, const char *fmt,...)
Definition: extconf.c:2195
#define LOG_WARNING
Definition: extconf.c:139
int errno
#define WEXITSTATUS(status)
#define WIFEXITED(status)
jack_status_t status
Definition: app_jack.c:146

◆ ast_set_lock_type()

void ast_set_lock_type ( enum AST_LOCK_TYPE  type)

Set the type of locks used by ast_lock_path()

Parameters
typethe locking type to use
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2452 of file main/app.c.

References type.

Referenced by load_asterisk_conf().

2453 {
2454  ast_lock_type = type;
2455 }
static const char type[]
Definition: chan_ooh323.c:109
ast_lock_type
Definition: lock.h:252

◆ ast_str_get_encoded_str()

int ast_str_get_encoded_str ( struct ast_str **  str,
int  maxlen,
const char *  stream 
)

Decode a stream of encoded control or extended ASCII characters.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 3015 of file main/app.c.

References ast_get_encoded_char(), ast_str_buffer(), ast_str_make_space, ast_str_set(), ast_str_size(), ast_str_update(), buf, and zombie::next.

Referenced by sendtext_exec(), and system_exec_helper().

3016 {
3017  char next, *buf;
3018  size_t offset = 0;
3019  size_t consumed;
3020 
3021  if (strchr(stream, '\\')) {
3022  while (!ast_get_encoded_char(stream, &next, &consumed)) {
3023  if (offset + 2 > ast_str_size(*str) && maxlen > -1) {
3024  ast_str_make_space(str, maxlen > 0 ? maxlen : (ast_str_size(*str) + 48) * 2 - 48);
3025  }
3026  if (offset + 2 > ast_str_size(*str)) {
3027  break;
3028  }
3029  buf = ast_str_buffer(*str);
3030  buf[offset++] = next;
3031  stream += consumed;
3032  }
3033  buf = ast_str_buffer(*str);
3034  buf[offset++] = '\0';
3035  ast_str_update(*str);
3036  } else {
3037  ast_str_set(str, maxlen, "%s", stream);
3038  }
3039  return 0;
3040 }
size_t ast_str_size(const struct ast_str *buf)
Returns the current maximum length (without reallocation) of the current buffer.
Definition: strings.h:699
char buf[BUFSIZE]
Definition: eagi_proxy.c:66
#define ast_str_make_space(buf, new_len)
Definition: strings.h:780
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
Definition: strings.h:714
int ast_str_set(struct ast_str **buf, ssize_t max_len, const char *fmt,...)
Set a dynamic string using variable arguments.
Definition: strings.h:1065
struct zombie * next
Definition: main/app.c:79
void ast_str_update(struct ast_str *buf)
Update the length of the buffer, after using ast_str merely as a buffer.
Definition: strings.h:663
int ast_get_encoded_char(const char *stream, char *result, size_t *consumed)
Decode an encoded control or extended ASCII character.
Definition: main/app.c:2927

◆ AST_THREADSTORAGE_EXTERNAL()

AST_THREADSTORAGE_EXTERNAL ( ast_str_thread_global_buf  )

◆ ast_uninstall_vm_test_functions()

void ast_uninstall_vm_test_functions ( void  )
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 606 of file main/app.c.

References ast_vm_test_create_user_func, ast_vm_test_destroy_user_func, and NULL.

Referenced by unload_module().

607 {
610 }
static ast_vm_test_create_user_fn * ast_vm_test_create_user_func
Definition: main/app.c:596
#define NULL
Definition: resample.c:96
static ast_vm_test_destroy_user_fn * ast_vm_test_destroy_user_func
Definition: main/app.c:597

◆ ast_unlock_path()

int ast_unlock_path ( const char *  path)

Unlock a path.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2473 of file main/app.c.

References AST_LOCK_TYPE_FLOCK, AST_LOCK_TYPE_LOCKFILE, ast_unlock_path_flock(), and ast_unlock_path_lockfile().

Referenced by __ast_play_and_record(), access_counter_file(), ast_module_reload(), close_mailbox(), copy_message(), count_messages(), leave_voicemail(), msg_create_from_file(), open_mailbox(), resequence_mailbox(), save_to_folder(), and test_vm_api_create_voicemail_files().

2474 {
2475  int r = 0;
2476 
2477  switch (ast_lock_type) {
2479  r = ast_unlock_path_lockfile(path);
2480  break;
2481  case AST_LOCK_TYPE_FLOCK:
2482  r = ast_unlock_path_flock(path);
2483  break;
2484  }
2485 
2486  return r;
2487 }
static int ast_unlock_path_flock(const char *path)
Definition: main/app.c:2422
ast_lock_type
Definition: lock.h:252
static int ast_unlock_path_lockfile(const char *path)
Definition: main/app.c:2300

◆ ast_unreplace_sigchld()

void ast_unreplace_sigchld ( void  )

Restore the SIGCHLD handler.

This function is called after a call to ast_replace_sigchld. It restores the SIGCHLD handler that cleans up any zombie processes.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 815 of file extconf.c.

References ast_mutex_lock, ast_mutex_unlock, ast_safe_system(), NULL, safe_system_level, safe_system_lock, and safe_system_prev_handler.

Referenced by ast_replace_sigchld(), ast_safe_fork_cleanup(), ast_safe_system(), AST_TEST_DEFINE(), and safe_exec_wait().

816 {
817  unsigned int level;
818 
819  level = --safe_system_level;
820 
821  /* only restore the handler if we are the last one */
822  if (level == 0) {
823  sigaction(SIGCHLD, &safe_system_prev_handler, NULL);
824  }
825 }
#define NULL
Definition: resample.c:96
static unsigned int safe_system_level
Keep track of how many threads are currently trying to wait*() on a child process.
Definition: extconf.c:785
static struct sigaction safe_system_prev_handler
Definition: extconf.c:786

◆ ast_vm_greeter_is_registered()

int ast_vm_greeter_is_registered ( void  )

Determine if a voicemail greeter provider is registered.

Since
13.0.0
Return values
0if no provider registered.
1if a provider is registered.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 541 of file main/app.c.

References ao2_cleanup, ao2_global_obj_ref, and table.

542 {
544  int is_registered;
545 
546  table = ao2_global_obj_ref(vm_greeter_provider);
547  is_registered = table ? 1 : 0;
548  ao2_cleanup(table);
549  return is_registered;
550 }
Voicemail greeter function table definition.
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
static char * table
Definition: cdr_odbc.c:58
#define ao2_cleanup(obj)
Definition: astobj2.h:1958

◆ ast_vm_greeter_unregister()

void ast_vm_greeter_unregister ( const char *  module_name)

Unregister the specified voicemail greeter provider.

Since
13.0.0
Parameters
Themodule name of the provider to unregister
Returns
Nothing
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 584 of file main/app.c.

References ao2_cleanup, ao2_global_obj_ref, ao2_global_obj_release, ast_vm_greeter_functions::module_name, and table.

Referenced by unload_module().

585 {
587 
588  table = ao2_global_obj_ref(vm_greeter_provider);
589  if (table && !strcmp(table->module_name, module_name)) {
590  ao2_global_obj_release(vm_greeter_provider);
591  }
592  ao2_cleanup(table);
593 }
Voicemail greeter function table definition.
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
static char * table
Definition: cdr_odbc.c:58
const char * module_name
The name of the module that provides the voicemail greeter functionality.
#define ao2_global_obj_release(holder)
Definition: astobj2.h:865
#define ao2_cleanup(obj)
Definition: astobj2.h:1958

◆ ast_vm_index_to_foldername()

const char* ast_vm_index_to_foldername ( int  id)

Return name of folder, given an id.

Parameters
[in]idFolder id
Returns
Name of folder
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 726 of file main/app.c.

References NULL, and VM_API_CALL.

727 {
728  const char *res = NULL;
729 
730  VM_API_CALL(res, index_to_foldername, (id));
731  return res;
732 }
#define NULL
Definition: resample.c:96
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620

◆ ast_vm_is_registered()

int ast_vm_is_registered ( void  )

Determine if a voicemail provider is registered.

Since
12.0.0
Return values
0if no provider registered.
1if a provider is registered.
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 430 of file main/app.c.

References ao2_cleanup, ao2_global_obj_ref, and table.

431 {
432  struct ast_vm_functions *table;
433  int is_registered;
434 
435  table = ao2_global_obj_ref(vm_provider);
436  is_registered = table ? 1 : 0;
437  ao2_cleanup(table);
438  return is_registered;
439 }
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
static char * table
Definition: cdr_odbc.c:58
#define ao2_cleanup(obj)
Definition: astobj2.h:1958
Voicemail function table definition.

◆ ast_vm_mailbox_snapshot_create()

struct ast_vm_mailbox_snapshot* ast_vm_mailbox_snapshot_create ( const char *  mailbox,
const char *  context,
const char *  folder,
int  descending,
enum ast_vm_snapshot_sort_val  sort_val,
int  combine_INBOX_and_OLD 
)

Create a snapshot of a mailbox which contains information about every msg.

Parameters
mailbox,themailbox to look for
context,thecontext to look for the mailbox in
folder,OPTIONAL.When not NULL only msgs from the specified folder will be included.
descending,listthe msgs in descending order rather than ascending order.
combine_INBOX_and_OLD,Whenthis argument is set, The OLD folder will be represented in the INBOX folder of the snapshot. This allows the snapshot to represent the OLD and INBOX messages in sorted order merged together.
Return values
snapshoton success
NULLon failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 734 of file main/app.c.

References NULL, and VM_API_CALL.

Referenced by test_vm_api_remove_all_messages().

740 {
741  struct ast_vm_mailbox_snapshot *res = NULL;
742 
743  VM_API_CALL(res, mailbox_snapshot_create, (mailbox, context, folder, descending,
744  sort_val, combine_INBOX_and_OLD));
745  return res;
746 }
#define NULL
Definition: resample.c:96
static char mailbox[AST_MAX_MAILBOX_UNIQUEID]
Definition: chan_mgcp.c:204
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620
static char context[AST_MAX_CONTEXT]
Definition: chan_alsa.c:116

◆ ast_vm_mailbox_snapshot_destroy()

struct ast_vm_mailbox_snapshot* ast_vm_mailbox_snapshot_destroy ( struct ast_vm_mailbox_snapshot mailbox_snapshot)

destroy a snapshot

Parameters
mailbox_snapshotThe snapshot to destroy.
Return values
NULL
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 748 of file main/app.c.

References NULL, and VM_API_CALL.

Referenced by AST_TEST_DEFINE(), and test_vm_api_remove_all_messages().

749 {
750  struct ast_vm_mailbox_snapshot *res = NULL;
751 
752  VM_API_CALL(res, mailbox_snapshot_destroy, (mailbox_snapshot));
753  return res;
754 }
#define NULL
Definition: resample.c:96
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620

◆ ast_vm_msg_forward()

int ast_vm_msg_forward ( const char *  from_mailbox,
const char *  from_context,
const char *  from_folder,
const char *  to_mailbox,
const char *  to_context,
const char *  to_folder,
size_t  num_msgs,
const char *  msg_ids[],
int  delete_old 
)

forward a message from one mailbox to another.

from_mailbox The original mailbox the message is being forwarded from from_context The voicemail context of the from_mailbox from_folder The folder from which the message is being forwarded to_mailbox The mailbox to forward the message to to_context The voicemail context of the to_mailbox to_folder The folder to which the message is being forwarded num_msgs The number of messages being forwarded msg_ids The message IDs of the messages in from_mailbox to forward delete_old If non-zero, the forwarded messages are also deleted from from_mailbox. Otherwise, the messages will remain in the from_mailbox.

Return values
-1Failure
0Success
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 782 of file main/app.c.

References VM_API_CALL.

791 {
792  int res = 0;
793 
794  VM_API_CALL(res, msg_forward, (from_mailbox, from_context, from_folder, to_mailbox,
795  to_context, to_folder, num_msgs, msg_ids, delete_old));
796  return res;
797 }
def from_mailbox(key, val, section, pjsip, nmapped)
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620

◆ ast_vm_msg_move()

int ast_vm_msg_move ( const char *  mailbox,
const char *  context,
size_t  num_msgs,
const char *  oldfolder,
const char *  old_msg_ids[],
const char *  newfolder 
)

Move messages from one folder to another.

Parameters
mailboxThe mailbox to which the folders belong
contextThe voicemail context for the mailbox
num_msgsThe number of messages to move
oldfolderThe folder from where messages should be moved
old_msg_idsThe message IDs of the messages to move
newfolderThe folder to which messages should be moved new folder. This array must be num_msgs sized.
Return values
-1Failure
0Success
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 756 of file main/app.c.

References VM_API_CALL.

762 {
763  int res = 0;
764 
765  VM_API_CALL(res, msg_move, (mailbox, context, num_msgs, oldfolder, old_msg_ids,
766  newfolder));
767  return res;
768 }
static char mailbox[AST_MAX_MAILBOX_UNIQUEID]
Definition: chan_mgcp.c:204
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620
static char context[AST_MAX_CONTEXT]
Definition: chan_alsa.c:116

◆ ast_vm_msg_play()

int ast_vm_msg_play ( struct ast_channel chan,
const char *  mailbox,
const char *  context,
const char *  folder,
const char *  msg_num,
ast_vm_msg_play_cb cb 
)

Play a voicemail msg back on a channel.

Parameters
chan
mailboxmsg is in.
contextof mailbox.
foldervoicemail folder to look in.
msg_nummessage number in the voicemailbox to playback to the channel.
cb
Return values
0success
-1failure
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 799 of file main/app.c.

References VM_API_CALL.

805 {
806  int res = 0;
807 
808  VM_API_CALL(res, msg_play, (chan, mailbox, context, folder, msg_num, cb));
809  return res;
810 }
static char mailbox[AST_MAX_MAILBOX_UNIQUEID]
Definition: chan_mgcp.c:204
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620
static char context[AST_MAX_CONTEXT]
Definition: chan_alsa.c:116

◆ ast_vm_msg_remove()

int ast_vm_msg_remove ( const char *  mailbox,
const char *  context,
size_t  num_msgs,
const char *  folder,
const char *  msgs[] 
)

Remove/delete messages from a mailbox folder.

Parameters
mailboxThe mailbox from which to delete messages
contextThe voicemail context for the mailbox
num_msgsThe number of messages to delete
folderThe folder from which to remove messages
msgsThe message IDs of the messages to delete
Return values
-1Failure
0Success
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 770 of file main/app.c.

References VM_API_CALL.

775 {
776  int res = 0;
777 
778  VM_API_CALL(res, msg_remove, (mailbox, context, num_msgs, folder, msgs));
779  return res;
780 }
static char mailbox[AST_MAX_MAILBOX_UNIQUEID]
Definition: chan_mgcp.c:204
#define VM_API_CALL(res, api_call, api_parms)
Definition: main/app.c:620
static char context[AST_MAX_CONTEXT]
Definition: chan_alsa.c:116

◆ ast_vm_test_create_user()

int ast_vm_test_create_user ( const char *  context,
const char *  mailbox 
)
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 813 of file main/app.c.

References ast_vm_test_create_user_func.

Referenced by test_vm_api_test_setup().

814 {
817  }
818  return 0;
819 }
static ast_vm_test_create_user_fn * ast_vm_test_create_user_func
Definition: main/app.c:596
static char mailbox[AST_MAX_MAILBOX_UNIQUEID]
Definition: chan_mgcp.c:204
static char context[AST_MAX_CONTEXT]
Definition: chan_alsa.c:116

◆ ast_vm_test_destroy_user()

int ast_vm_test_destroy_user ( const char *  context,
const char *  mailbox 
)
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 821 of file main/app.c.

References ast_vm_test_destroy_user_func.

Referenced by test_vm_api_test_teardown().

822 {
825  }
826  return 0;
827 }
static char mailbox[AST_MAX_MAILBOX_UNIQUEID]
Definition: chan_mgcp.c:204
static ast_vm_test_destroy_user_fn * ast_vm_test_destroy_user_func
Definition: main/app.c:597
static char context[AST_MAX_CONTEXT]
Definition: chan_alsa.c:116

◆ ast_vm_test_swap_table_in()

void ast_vm_test_swap_table_in ( const struct ast_vm_functions vm_table)

Swap out existing voicemail functions with a temporary set of functions for use with unit tests.

Parameters
vm_tablefunction table to use for testing
Note
ast_vm_test_swap_table_out should be called to restore the original set before testing concludes
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 489 of file main/app.c.

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_alloc_options, ao2_cleanup, ao2_global_obj_ref, ao2_global_obj_replace_unref, ast_log, LOG_ERROR, NULL, provider_is_swapped, RAII_VAR, and vm_table.

490 {
491  RAII_VAR(struct ast_vm_functions *, holding_table, NULL, ao2_cleanup);
492  RAII_VAR(struct ast_vm_functions *, new_table, NULL, ao2_cleanup);
493 
494  if (provider_is_swapped) {
495  ast_log(LOG_ERROR, "Attempted to swap in test function table without swapping out old test table.\n");
496  return;
497  }
498 
499  holding_table = ao2_global_obj_ref(vm_provider);
500 
501  if (holding_table) {
502  ao2_global_obj_replace_unref(vm_provider_holder, holding_table);
503  }
504 
505  new_table = ao2_alloc_options(sizeof(*new_table), NULL, AO2_ALLOC_OPT_LOCK_NOLOCK);
506  if (!new_table) {
507  return;
508  }
509  *new_table = *vm_table;
510 
511  ao2_global_obj_replace_unref(vm_provider, new_table);
513 }
static const struct ast_vm_functions vm_table
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
#define ao2_alloc_options(data_size, destructor_fn, options)
Definition: astobj2.h:406
#define NULL
Definition: resample.c:96
#define ast_log
Definition: astobj2.c:42
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
static int provider_is_swapped
Definition: main/app.c:487
#define LOG_ERROR
Definition: logger.h:285
#define ao2_global_obj_replace_unref(holder, obj)
Definition: astobj2.h:908
#define ao2_cleanup(obj)
Definition: astobj2.h:1958
Voicemail function table definition.

◆ ast_vm_test_swap_table_out()

void ast_vm_test_swap_table_out ( void  )

Used after ast_vm_test_swap_table_in to restore the original set of voicemail functions.

Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 515 of file main/app.c.

References ao2_cleanup, ao2_global_obj_ref, ao2_global_obj_release, ao2_global_obj_replace_unref, AO2_GLOBAL_OBJ_STATIC(), ast_log, LOG_ERROR, NULL, provider_is_swapped, and RAII_VAR.

516 {
517  RAII_VAR(struct ast_vm_functions *, held_table, NULL, ao2_cleanup);
518 
519  if (!provider_is_swapped) {
520  ast_log(LOG_ERROR, "Attempted to swap out test function table, but none is currently installed.\n");
521  return;
522  }
523 
524  held_table = ao2_global_obj_ref(vm_provider_holder);
525  if (!held_table) {
526  return;
527  }
528 
529  ao2_global_obj_replace_unref(vm_provider, held_table);
530  ao2_global_obj_release(vm_provider_holder);
532 }
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
#define NULL
Definition: resample.c:96
#define ast_log
Definition: astobj2.c:42
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
static int provider_is_swapped
Definition: main/app.c:487
#define LOG_ERROR
Definition: logger.h:285
#define ao2_global_obj_release(holder)
Definition: astobj2.h:865
#define ao2_global_obj_replace_unref(holder, obj)
Definition: astobj2.h:908
#define ao2_cleanup(obj)
Definition: astobj2.h:1958
Voicemail function table definition.

◆ ast_vm_unregister()

void ast_vm_unregister ( const char *  module_name)

Unregister the specified voicemail provider.

Parameters
Themodule name of the provider to unregister
Returns
Nothing
Examples:
/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 473 of file main/app.c.

References ao2_cleanup, ao2_global_obj_ref, ao2_global_obj_release, AO2_GLOBAL_OBJ_STATIC(), ast_vm_functions::module_name, and table.

Referenced by unload_module().

474 {
475  struct ast_vm_functions *table;
476 
477  table = ao2_global_obj_ref(vm_provider);
478  if (table && !strcmp(table->module_name, module_name)) {
479  ao2_global_obj_release(vm_provider);
480  }
481  ao2_cleanup(table);
482 }
#define ao2_global_obj_ref(holder)
Definition: astobj2.h:925
static char * table
Definition: cdr_odbc.c:58
#define ao2_global_obj_release(holder)
Definition: astobj2.h:865
const char * module_name
The name of the module that provides the voicemail functionality.
#define ao2_cleanup(obj)
Definition: astobj2.h:1958
Voicemail function table definition.