Asterisk main include file. File version handling, generic pbx functions. More...
#include "asterisk/autoconfig.h"
#include "asterisk/compat.h"
Go to the source code of this file.
Defines | |
#define | AST_DIR_MODE 0777 |
#define | AST_FILE_MODE 0666 |
#define | ASTERISK_FILE_VERSION(file, version) |
Register/unregister a source code file with the core. | |
#define | bcopy 0x__dont_use_bcopy__use_memmove_instead() |
#define | bzero 0x__dont_use_bzero__use_memset_instead"" |
#define | DEFAULT_LANGUAGE "en" |
#define | DEFAULT_SAMPLE_RATE 8000 |
#define | DEFAULT_SAMPLES_PER_MS ((DEFAULT_SAMPLE_RATE)/1000) |
#define | sched_setscheduler __PLEASE_USE_ast_set_priority_INSTEAD_OF_sched_setscheduler__ |
#define | setpriority __PLEASE_USE_ast_set_priority_INSTEAD_OF_setpriority__ |
Functions | |
int | ast_add_profile (const char *, uint64_t scale) |
support for event profiling | |
char * | ast_complete_source_filename (const char *partial, int n) |
int | ast_fd_init (void) |
const char * | ast_file_version_find (const char *file) |
Find version for given module name. | |
int64_t | ast_mark (int, int start1_stop0) |
int | ast_pbx_init (void) |
int64_t | ast_profile (int, int64_t) |
int | ast_register_atexit (void(*func)(void)) |
Register a function to be executed before Asterisk exits. | |
void | ast_register_file_version (const char *file, const char *version) |
Register the version of a source code file with the core. | |
int | ast_set_priority (int) |
We set ourselves to a high priority, that we might pre-empt everything else. If your PBX has heavy activity on it, this is a good thing. | |
void | ast_unregister_atexit (void(*func)(void)) |
Unregister a function registered with ast_register_atexit(). | |
void | ast_unregister_file_version (const char *file) |
Unregister a source code file from the core. |
Asterisk main include file. File version handling, generic pbx functions.
Definition in file asterisk.h.
#define AST_DIR_MODE 0777 |
Definition at line 33 of file asterisk.h.
#define AST_FILE_MODE 0666 |
Definition at line 36 of file asterisk.h.
Referenced by __ast_play_and_record(), action_createconfig(), ast_lock_path_lockfile(), ast_monitor_start(), chanspy_exec(), copy(), dbinit(), dictate_exec(), extenspy_exec(), festival_exec(), handle_cli_file_convert(), handle_recordfile(), load_module(), record_exec(), recordthread(), sms_log(), and try_firmware().
#define ASTERISK_FILE_VERSION | ( | file, | |||
version | ) |
Register/unregister a source code file with the core.
file | the source file name | |
version | the version string (typically a SVN revision keyword string) |
This macro will place a file-scope constructor and destructor into the source of the module using it; this will cause the version of this file to registered with the Asterisk core (and unregistered) at the appropriate times.
Example:
ASTERISK_FILE_VERSION(__FILE__, "\$Revision\$")
Definition at line 164 of file asterisk.h.
#define bcopy 0x__dont_use_bcopy__use_memmove_instead() |
Definition at line 224 of file asterisk.h.
#define bzero 0x__dont_use_bzero__use_memset_instead"" |
Definition at line 223 of file asterisk.h.
#define DEFAULT_LANGUAGE "en" |
Definition at line 39 of file asterisk.h.
Referenced by fileexists_core().
#define DEFAULT_SAMPLE_RATE 8000 |
Definition at line 41 of file asterisk.h.
Referenced by check_header(), ogg_vorbis_open(), ogg_vorbis_rewrite(), setformat(), and write_header().
#define DEFAULT_SAMPLES_PER_MS ((DEFAULT_SAMPLE_RATE)/1000) |
Definition at line 42 of file asterisk.h.
Referenced by ast_stream_fastforward(), ast_stream_rewind(), and isAnsweringMachine().
#define sched_setscheduler __PLEASE_USE_ast_set_priority_INSTEAD_OF_sched_setscheduler__ |
Definition at line 44 of file asterisk.h.
Referenced by ast_set_priority().
#define setpriority __PLEASE_USE_ast_set_priority_INSTEAD_OF_setpriority__ |
Definition at line 43 of file asterisk.h.
Referenced by ast_set_priority().
int ast_add_profile | ( | const char * | name, | |
uint64_t | scale | |||
) |
support for event profiling
(note, this must be documented a lot more) ast_add_profile allocates a generic 'counter' with a given name, which can be shown with the command 'core show profile <name>'
The counter accumulates positive or negative values supplied by
support for event profiling
Definition at line 707 of file asterisk.c.
References ast_calloc, ast_realloc, ast_strdup, profile_data::e, profile_data::entries, profile_entry::events, profile_entry::mark, profile_data::max_size, profile_entry::name, prof_data, profile_entry::scale, and profile_entry::value.
Referenced by extension_match_core().
00708 { 00709 int l = sizeof(struct profile_data); 00710 int n = 10; /* default entries */ 00711 00712 if (prof_data == NULL) { 00713 prof_data = ast_calloc(1, l + n*sizeof(struct profile_entry)); 00714 if (prof_data == NULL) 00715 return -1; 00716 prof_data->entries = 0; 00717 prof_data->max_size = n; 00718 } 00719 if (prof_data->entries >= prof_data->max_size) { 00720 void *p; 00721 n = prof_data->max_size + 20; 00722 p = ast_realloc(prof_data, l + n*sizeof(struct profile_entry)); 00723 if (p == NULL) 00724 return -1; 00725 prof_data = p; 00726 prof_data->max_size = n; 00727 } 00728 n = prof_data->entries++; 00729 prof_data->e[n].name = ast_strdup(name); 00730 prof_data->e[n].value = 0; 00731 prof_data->e[n].events = 0; 00732 prof_data->e[n].mark = 0; 00733 prof_data->e[n].scale = scale; 00734 return n; 00735 }
char* ast_complete_source_filename | ( | const char * | partial, | |
int | n | |||
) |
Definition at line 356 of file asterisk.c.
References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdup, file_version::file, len(), and ast_atexit::list.
Referenced by handle_verbose().
00357 { 00358 struct file_version *find; 00359 size_t len = strlen(partial); 00360 int count = 0; 00361 char *res = NULL; 00362 00363 AST_RWLIST_RDLOCK(&file_versions); 00364 AST_RWLIST_TRAVERSE(&file_versions, find, list) { 00365 if (!strncasecmp(find->file, partial, len) && ++count > n) { 00366 res = ast_strdup(find->file); 00367 break; 00368 } 00369 } 00370 AST_RWLIST_UNLOCK(&file_versions); 00371 return res; 00372 }
int ast_fd_init | ( | void | ) |
const char* ast_file_version_find | ( | const char * | file | ) |
Find version for given module name.
file | Module name (i.e. chan_sip.so) |
Definition at line 375 of file asterisk.c.
References AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, file_version::file, ast_atexit::list, and file_version::version.
Referenced by manager_modulecheck().
00376 { 00377 struct file_version *iterator; 00378 00379 AST_RWLIST_WRLOCK(&file_versions); 00380 AST_RWLIST_TRAVERSE(&file_versions, iterator, list) { 00381 if (!strcasecmp(iterator->file, file)) 00382 break; 00383 } 00384 AST_RWLIST_UNLOCK(&file_versions); 00385 if (iterator) 00386 return iterator->version; 00387 return NULL; 00388 }
int64_t ast_mark | ( | int | , | |
int | start1_stop0 | |||
) |
Definition at line 772 of file asterisk.c.
References profile_data::e, profile_data::entries, profile_entry::events, profile_entry::mark, prof_data, rdtsc(), profile_entry::scale, and profile_entry::value.
Referenced by __ast_pthread_mutex_lock(), and extension_match_core().
00773 { 00774 if (!prof_data || i < 0 || i > prof_data->entries) /* invalid index */ 00775 return 0; 00776 if (startstop == 1) 00777 prof_data->e[i].mark = rdtsc(); 00778 else { 00779 prof_data->e[i].mark = (rdtsc() - prof_data->e[i].mark); 00780 if (prof_data->e[i].scale > 1) 00781 prof_data->e[i].mark /= prof_data->e[i].scale; 00782 prof_data->e[i].value += prof_data->e[i].mark; 00783 prof_data->e[i].events++; 00784 } 00785 return prof_data->e[i].mark; 00786 }
int ast_pbx_init | ( | void | ) |
Provided by pbx.c
Definition at line 10983 of file pbx.c.
References ao2_container_alloc, ast_register_atexit(), HASH_EXTENHINT_SIZE, hint_cmp(), hint_hash(), hints, pbx_shutdown(), statecbs, and statecbs_cmp().
Referenced by main().
10984 { 10985 hints = ao2_container_alloc(HASH_EXTENHINT_SIZE, hint_hash, hint_cmp); 10986 statecbs = ao2_container_alloc(1, NULL, statecbs_cmp); 10987 10988 ast_register_atexit(pbx_shutdown); 10989 10990 return (hints && statecbs) ? 0 : -1; 10991 }
int64_t ast_profile | ( | int | , | |
int64_t | ||||
) |
Definition at line 737 of file asterisk.c.
References profile_data::e, profile_data::entries, profile_entry::events, prof_data, profile_entry::scale, and profile_entry::value.
int ast_register_atexit | ( | void(*)(void) | func | ) |
Register a function to be executed before Asterisk exits.
func | The callback function to use. |
0 | on success. | |
-1 | on error. |
Definition at line 976 of file asterisk.c.
References __ast_unregister_atexit(), ast_calloc, AST_LIST_INSERT_HEAD, AST_LIST_LOCK, AST_LIST_UNLOCK, ast_atexit::func, and ast_atexit::list.
Referenced by __ast_mm_init_phase_2(), __init_manager(), ast_aoc_cli_init(), ast_builtins_init(), ast_cc_init(), ast_cdr_engine_init(), ast_cel_engine_init(), ast_channels_init(), ast_data_init(), ast_event_init(), ast_features_init(), ast_file_init(), ast_http_init(), ast_image_init(), ast_indications_init(), ast_pbx_init(), ast_stun_init(), ast_timing_init(), ast_tps_init(), ast_udptl_init(), astdb_init(), dnsmgr_init(), do_reload(), init_framer(), load_module(), load_pbx(), main(), and register_config_cli().
00977 { 00978 struct ast_atexit *ae; 00979 00980 ae = ast_calloc(1, sizeof(*ae)); 00981 if (!ae) { 00982 return -1; 00983 } 00984 ae->func = func; 00985 00986 AST_LIST_LOCK(&atexits); 00987 __ast_unregister_atexit(func); 00988 AST_LIST_INSERT_HEAD(&atexits, ae, list); 00989 AST_LIST_UNLOCK(&atexits); 00990 00991 return 0; 00992 }
void ast_register_file_version | ( | const char * | file, | |
const char * | version | |||
) |
Register the version of a source code file with the core.
file | the source file name | |
version | the version string (typically a SVN revision keyword string) |
This function should not be called directly, but instead the ASTERISK_FILE_VERSION macro should be used to register a file with the core.
Definition at line 317 of file asterisk.c.
References ast_calloc, AST_RWLIST_INSERT_HEAD, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_strdupa, ast_strip(), and ast_strip_quoted().
00318 { 00319 struct file_version *new; 00320 char *work; 00321 size_t version_length; 00322 00323 work = ast_strdupa(version); 00324 work = ast_strip(ast_strip_quoted(work, "$", "$")); 00325 version_length = strlen(work) + 1; 00326 00327 if (!(new = ast_calloc(1, sizeof(*new) + version_length))) 00328 return; 00329 00330 new->file = file; 00331 new->version = (char *) new + sizeof(*new); 00332 memcpy(new->version, work, version_length); 00333 AST_RWLIST_WRLOCK(&file_versions); 00334 AST_RWLIST_INSERT_HEAD(&file_versions, new, list); 00335 AST_RWLIST_UNLOCK(&file_versions); 00336 }
int ast_set_priority | ( | int | ) |
We set ourselves to a high priority, that we might pre-empt everything else. If your PBX has heavy activity on it, this is a good thing.
Provided by asterisk.c
Definition at line 1636 of file asterisk.c.
References ast_log(), ast_verbose, LOG_WARNING, sched_setscheduler, and setpriority.
Referenced by app_exec(), ast_safe_system(), canary_thread(), icesencode(), launch_script(), main(), mp3play(), NBScatplay(), send_waveform_to_fd(), spawn_mp3(), and spawn_ras().
01637 { 01638 struct sched_param sched; 01639 memset(&sched, 0, sizeof(sched)); 01640 #ifdef __linux__ 01641 if (pri) { 01642 sched.sched_priority = 10; 01643 if (sched_setscheduler(0, SCHED_RR, &sched)) { 01644 ast_log(LOG_WARNING, "Unable to set high priority\n"); 01645 return -1; 01646 } else 01647 if (option_verbose) 01648 ast_verbose("Set to realtime thread\n"); 01649 } else { 01650 sched.sched_priority = 0; 01651 /* According to the manpage, these parameters can never fail. */ 01652 sched_setscheduler(0, SCHED_OTHER, &sched); 01653 } 01654 #else 01655 if (pri) { 01656 if (setpriority(PRIO_PROCESS, 0, -10) == -1) { 01657 ast_log(LOG_WARNING, "Unable to set high priority\n"); 01658 return -1; 01659 } else 01660 if (option_verbose) 01661 ast_verbose("Set to high priority\n"); 01662 } else { 01663 /* According to the manpage, these parameters can never fail. */ 01664 setpriority(PRIO_PROCESS, 0, 0); 01665 } 01666 #endif 01667 return 0; 01668 }
void ast_unregister_atexit | ( | void(*)(void) | func | ) |
Unregister a function registered with ast_register_atexit().
func | The callback function to unregister. |
Definition at line 994 of file asterisk.c.
References __ast_unregister_atexit(), AST_LIST_LOCK, AST_LIST_UNLOCK, and ast_atexit::func.
Referenced by do_reload(), and unload_module().
00995 { 00996 AST_LIST_LOCK(&atexits); 00997 __ast_unregister_atexit(func); 00998 AST_LIST_UNLOCK(&atexits); 00999 }
void ast_unregister_file_version | ( | const char * | file | ) |
Unregister a source code file from the core.
file | the source file name |
This function should not be called directly, but instead the ASTERISK_FILE_VERSION macro should be used to automatically unregister the file when the module is unloaded.
Definition at line 338 of file asterisk.c.
References ast_free, AST_RWLIST_REMOVE_CURRENT, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, file_version::file, and ast_atexit::list.
00339 { 00340 struct file_version *find; 00341 00342 AST_RWLIST_WRLOCK(&file_versions); 00343 AST_RWLIST_TRAVERSE_SAFE_BEGIN(&file_versions, find, list) { 00344 if (!strcasecmp(find->file, file)) { 00345 AST_RWLIST_REMOVE_CURRENT(list); 00346 break; 00347 } 00348 } 00349 AST_RWLIST_TRAVERSE_SAFE_END; 00350 AST_RWLIST_UNLOCK(&file_versions); 00351 00352 if (find) 00353 ast_free(find); 00354 }