Main Page | Alphabetical List | Data Structures | File List | Data Fields | Globals

logger.h File Reference

#include <stdarg.h>

Go to the source code of this file.

Defines

#define EVENTLOG   "event_log"
#define DEBUG_M(a)
#define _A_   __FILE__, __LINE__, __PRETTY_FUNCTION__
#define __LOG_DEBUG   0
#define LOG_DEBUG   __LOG_DEBUG, _A_
#define __LOG_EVENT   1
#define LOG_EVENT   __LOG_EVENT, _A_
#define __LOG_NOTICE   2
#define LOG_NOTICE   __LOG_NOTICE, _A_
#define __LOG_WARNING   3
#define LOG_WARNING   __LOG_WARNING, _A_
#define __LOG_ERROR   4
#define LOG_ERROR   __LOG_ERROR, _A_
#define __LOG_VERBOSE   5
#define LOG_VERBOSE   __LOG_VERBOSE, _A_

Functions

void ast_log (int level, const char *file, int line, const char *function, const char *fmt,...) __attribute__((format(printf
 Used for sending a log message.

void ast_verbose (const char *fmt,...) __attribute__((format(printf
 Send a verbose message (based on verbose level).

int ast_register_verbose (void(*verboser)(const char *string, int opos, int replacelast, int complete))
int ast_unregister_verbose (void(*verboser)(const char *string, int opos, int replacelast, int complete))
int ast_verbose_dmesg (void(*verboser)(const char *string, int opos, int replacelast, int complete))
void ast_console_puts (const char *string)


Define Documentation

#define __LOG_DEBUG   0
 

Definition at line 64 of file logger.h.

Referenced by ast_log().

#define __LOG_ERROR   4
 

Definition at line 88 of file logger.h.

#define __LOG_EVENT   1
 

Definition at line 70 of file logger.h.

Referenced by ast_log().

#define __LOG_NOTICE   2
 

Definition at line 76 of file logger.h.

#define __LOG_VERBOSE   5
 

Definition at line 94 of file logger.h.

Referenced by ast_log().

#define __LOG_WARNING   3
 

Definition at line 82 of file logger.h.

#define _A_   __FILE__, __LINE__, __PRETTY_FUNCTION__
 

Definition at line 59 of file logger.h.

#define DEBUG_M  ) 
 

Value:

{ \
   a; \
}

Definition at line 25 of file logger.h.

#define EVENTLOG   "event_log"
 

Definition at line 23 of file logger.h.

Referenced by init_logger(), and reload_logger().

#define LOG_DEBUG   __LOG_DEBUG, _A_
 

Definition at line 65 of file logger.h.

Referenced by ast_channel_bridge(), ast_channel_masquerade(), ast_channel_register_ex(), ast_channel_unregister(), ast_db_del(), ast_db_get(), ast_get_enum(), ast_hangup(), ast_indicate(), ast_io_add(), ast_io_dump(), ast_io_wait(), ast_ouraddrfor(), ast_pbx_run(), ast_prod(), ast_queue_frame(), ast_read(), ast_rtcp_read(), ast_rtp_bridge(), ast_rtp_read(), ast_rtp_write(), ast_say_date_with_format(), ast_say_number(), ast_say_number_full(), ast_sched_add(), ast_sched_del(), ast_sched_dump(), ast_sched_runq(), ast_sched_wait(), ast_search_dns(), ast_set_read_format(), ast_set_write_format(), ast_settimeout(), ast_softhangup_nolock(), ast_streamfile(), ast_waitstream(), ast_waitstream_fr(), ast_waitstream_full(), ast_writestream(), load_modules(), and pbx_substitute_variables_helper().

#define LOG_ERROR   __LOG_ERROR, _A_
 

Definition at line 89 of file logger.h.

Referenced by ast_channel_setoption(), ast_get_group(), ast_ouraddrfor(), ast_pbx_run(), ast_register_application(), ast_register_switch(), ast_unregister_switch(), ast_verbose(), init_logger(), main(), and reload_logger().

#define LOG_EVENT   __LOG_EVENT, _A_
 

Definition at line 71 of file logger.h.

Referenced by ast_log(), init_logger(), and reload_logger().

#define LOG_NOTICE   __LOG_NOTICE, _A_
 

Definition at line 77 of file logger.h.

Referenced by __ast_request_and_dial(), ast_app_getvoice(), ast_db_get(), ast_get_indication_zone(), ast_io_remove(), ast_read(), ast_rtp_read(), ast_rtp_senddigit(), ast_sched_add(), ast_sched_del(), ast_sched_runq(), ast_set_read_format(), ast_set_write_format(), ast_unregister_indication_country(), init_manager(), and pbx_substitute_variables_helper().

#define LOG_VERBOSE   __LOG_VERBOSE, _A_
 

Definition at line 95 of file logger.h.

Referenced by ast_verbose().

#define LOG_WARNING   __LOG_WARNING, _A_
 

Definition at line 83 of file logger.h.

Referenced by __ast_request_and_dial(), ast_app_getvoice(), ast_append_ha(), ast_autoservice_start(), ast_best_codec(), ast_cdr_answer(), ast_cdr_busy(), ast_cdr_disposition(), ast_cdr_end(), ast_cdr_failed(), ast_cdr_free(), ast_cdr_init(), ast_cdr_post(), ast_cdr_register(), ast_cdr_setapp(), ast_cdr_setdestchan(), ast_cdr_start(), ast_channel_alloc(), ast_channel_bridge(), ast_channel_free(), ast_channel_make_compatible(), ast_channel_masquerade(), ast_channel_register_ex(), ast_channel_unregister(), ast_cli_command(), ast_cli_register(), ast_cli_unregister(), ast_db_gettree(), ast_db_put(), ast_device_state(), ast_dsp_process(), ast_format_register(), ast_format_unregister(), ast_fr_fdread(), ast_fr_fdwrite(), ast_frisolate(), ast_get_group(), ast_get_indication_tone(), ast_get_indication_zone(), ast_get_ip(), ast_hangup(), ast_indicate(), ast_io_remove(), ast_load_resource(), ast_loader_register(), ast_loader_unregister(), ast_lookup_iface(), ast_manager_register(), ast_openstream(), ast_openvstream(), ast_ouraddrfor(), ast_pbx_run(), ast_pbx_start(), ast_playtones_start(), ast_prod(), ast_queue_frame(), ast_read(), ast_read_image(), ast_readfile(), ast_register_application(), ast_register_indication(), ast_register_indication_country(), ast_register_switch(), ast_register_translator(), ast_request(), ast_rtcp_read(), ast_rtp_bridge(), ast_rtp_new(), ast_rtp_proto_register(), ast_rtp_read(), ast_rtp_reload(), ast_rtp_senddigit(), ast_rtp_settos(), ast_rtp_write(), ast_say_date_with_format(), ast_search_dns(), ast_smoother_feed(), ast_stopstream(), ast_streamfile(), ast_translate(), ast_translator_build_path(), ast_unload_resource(), ast_unregister_indication(), ast_unregister_indication_country(), ast_update_use_count(), ast_var_assign(), ast_waitfor_nandfds(), ast_waitstream(), ast_waitstream_fr(), ast_waitstream_full(), ast_write(), ast_writefile(), ast_writestream(), init_manager(), load_modules(), main(), pbx_exec(), and pbx_findapp().


Function Documentation

void ast_console_puts const char *  string  ) 
 

Definition at line 174 of file asterisk.c.

References string.

Referenced by ast_log().

00175 {
00176     fputs(string, stdout);
00177     fflush(stdout);
00178     ast_network_puts(string);
00179 }

void ast_log int  level,
const char *  file,
int  line,
const char *  function,
const char *  fmt,
  ...
 

Used for sending a log message.

Parameters:
level don't need to worry about it
file ditto
line ditto
function ditto
fmt this is what is important. The format is the same as your favorite breed of printf. You know how that works, right? :-) This is the standard logger function. Probably the only way you will invoke it would be something like this: ast_log(LOG_WHATEVER, "Problem with the %s Captain. We should get some more. Will %d be enough?", "flux capacitor", 10); where WHATEVER is one of ERROR, DEBUG, EVENT, NOTICE, or WARNING depending on which log you wish to output to.

Referenced by __ast_request_and_dial(), ast_app_getvoice(), ast_append_ha(), ast_autoservice_start(), ast_best_codec(), ast_cdr_answer(), ast_cdr_busy(), ast_cdr_disposition(), ast_cdr_end(), ast_cdr_failed(), ast_cdr_free(), ast_cdr_init(), ast_cdr_post(), ast_cdr_register(), ast_cdr_setapp(), ast_cdr_setdestchan(), ast_cdr_start(), ast_channel_alloc(), ast_channel_bridge(), ast_channel_free(), ast_channel_make_compatible(), ast_channel_masquerade(), ast_channel_register_ex(), ast_channel_setoption(), ast_channel_unregister(), ast_cli_command(), ast_cli_register(), ast_cli_unregister(), ast_db_del(), ast_db_get(), ast_db_gettree(), ast_db_put(), ast_device_state(), ast_dsp_process(), ast_format_register(), ast_format_unregister(), ast_fr_fdread(), ast_fr_fdwrite(), ast_frisolate(), ast_get_enum(), ast_get_group(), ast_get_indication_tone(), ast_get_indication_zone(), ast_get_ip(), ast_hangup(), ast_indicate(), ast_io_add(), ast_io_dump(), ast_io_remove(), ast_io_wait(), ast_load_resource(), ast_loader_register(), ast_loader_unregister(), ast_log(), ast_lookup_iface(), ast_manager_register(), ast_openstream(), ast_openvstream(), ast_ouraddrfor(), ast_pbx_run(), ast_pbx_start(), ast_playtones_start(), ast_prod(), ast_queue_frame(), ast_read(), ast_read_image(), ast_readfile(), ast_register_application(), ast_register_indication(), ast_register_indication_country(), ast_register_switch(), ast_register_translator(), ast_request(), ast_rtcp_read(), ast_rtp_bridge(), ast_rtp_new(), ast_rtp_proto_register(), ast_rtp_read(), ast_rtp_reload(), ast_rtp_senddigit(), ast_rtp_settos(), ast_rtp_write(), ast_say_date_with_format(), ast_say_number(), ast_say_number_full(), ast_sched_add(), ast_sched_del(), ast_sched_dump(), ast_sched_runq(), ast_sched_wait(), ast_search_dns(), ast_set_read_format(), ast_set_write_format(), ast_settimeout(), ast_smoother_feed(), ast_softhangup_nolock(), ast_stopstream(), ast_streamfile(), ast_translate(), ast_translator_build_path(), ast_unload_resource(), ast_unregister_indication(), ast_unregister_indication_country(), ast_unregister_switch(), ast_update_use_count(), ast_var_assign(), ast_verbose(), ast_waitfor_nandfds(), ast_waitstream(), ast_waitstream_fr(), ast_waitstream_full(), ast_write(), ast_writefile(), ast_writestream(), init_logger(), init_manager(), load_modules(), main(), pbx_exec(), pbx_findapp(), pbx_substitute_variables_helper(), and reload_logger().

int ast_register_verbose void(*  verboser)(const char *string, int opos, int replacelast, int complete)  ) 
 

Definition at line 582 of file logger.c.

References ast_mutex_lock, ast_mutex_unlock, and malloc.

Referenced by main().

00582 {
00583    struct msglist *m;
00584    struct verb *tmp;
00585    /* XXX Should be more flexible here, taking > 1 verboser XXX */
00586    if ((tmp = malloc(sizeof (struct verb)))) {
00587       tmp->verboser = v;
00588       ast_mutex_lock(&msglist_lock);
00589       tmp->next = verboser;
00590       verboser = tmp;
00591       m = list;
00592       while(m) {
00593          /* Send all the existing entries that we have queued (i.e. they're likely to have missed) */
00594          v(m->msg, 0, 0, 1);
00595          m = m->next;
00596       }
00597       ast_mutex_unlock(&msglist_lock);
00598       return 0;
00599    }
00600    return -1;
00601 }
00602 

int ast_unregister_verbose void(*  verboser)(const char *string, int opos, int replacelast, int complete)  ) 
 

Definition at line 604 of file logger.c.

References ast_mutex_lock, ast_mutex_unlock, and free.

00604 {
00605    int res = -1;
00606    struct verb *tmp, *tmpl=NULL;
00607    ast_mutex_lock(&msglist_lock);
00608    tmp = verboser;
00609    while(tmp) {
00610       if (tmp->verboser == v) {
00611          if (tmpl)
00612             tmpl->next = tmp->next;
00613          else
00614             verboser = tmp->next;
00615          free(tmp);
00616          break;
00617       }
00618       tmpl = tmp;
00619       tmp = tmp->next;
00620    }
00621    if (tmp)
00622       res = 0;
00623    ast_mutex_unlock(&msglist_lock);
00624    return res;
00625 }
00626 }

void ast_verbose const char *  fmt,
  ...
 

Send a verbose message (based on verbose level).

This works like ast_log, but prints verbose messages to the console depending on verbosity level set. ast_verbose(VERBOSE_PREFIX_3 "Whatever %s is happening\n", "nothing"); This will print the message to the console if the verbose level is set to a level >= 3 Note the abscence of a comma after the VERBOSE_PREFIX_3. This is important. VERBOSE_PREFIX_1 through VERBOSE_PREFIX_3 are defined.

Referenced by ast_channel_bridge(), ast_channel_register_ex(), ast_channel_unregister(), ast_format_register(), ast_format_unregister(), ast_frame_dump(), ast_image_register(), ast_image_unregister(), ast_load_resource(), ast_log(), ast_manager_register(), ast_manager_unregister(), ast_module_reload(), ast_pbx_run(), ast_register_application(), ast_register_indication_country(), ast_register_translator(), ast_rtp_reload(), ast_save(), ast_set_indication_country(), ast_streamfile(), ast_unregister_indication_country(), init_logger(), init_manager(), load_modules(), main(), pbx_builtin_setvar_helper(), and reload_logger().

int ast_verbose_dmesg void(*  verboser)(const char *string, int opos, int replacelast, int complete)  ) 
 

Definition at line 568 of file logger.c.

References ast_mutex_lock, and ast_mutex_unlock.

00568 {
00569    struct msglist *m;
00570    m = list;
00571    ast_mutex_lock(&msglist_lock);
00572    while(m) {
00573       /* Send all the existing entries that we have queued (i.e. they're likely to have missed) */
00574       v(m->msg, 0, 0, 1);
00575       m = m->next;
00576    }
00577    ast_mutex_unlock(&msglist_lock);
00578    return 0;
00579 }
00580 


Generated on Sun Apr 18 23:34:07 2004 for Asterisk by doxygen 1.3.6-20040222